User Permissions | Organization Admins. |
Note: Only an Organization Admin sees Validate. Available with Flowcode 2. If you don't see Organization admin at the top of Flowcode, ask an Organization Admin.
Check your domain's status
At the top right of any page, click Organization admin.
At the bottom left, click Settings.
Click the Domains tab.
Find the domain's row and read its Status:
Active: validated, with an SSL certificate. Only Active domains can be used on flows.
Pending: added, but Flowcode can't yet confirm your DNS records or that you own the domain. Hover over the icon to see "Please add the domain to your DNS configuration".
Moved: DNS records weren't in place within a day or two of adding the domain. Validate doesn't fix it. Only Flowcode Support can reset it.
Deleted: Flowcode Support needs to delete the domain and add it again.
Check your DNS records
Look up your hostname (for example, qr.example.com) in a public DNS lookup tool and check these points:
A subdomain has a CNAME record pointing to
whitelabel.flowsto.com. This is the recommended setup.A root domain, or a subdomain set up with addresses instead, has A and AAAA records matching the IP addresses in the Add a Custom Domain window (Create domain). Copy them from the window rather than from an old setup.
It has no other A, AAAA, or CNAME records left from an earlier setup.
If your DNS is hosted on Cloudflare, every record is DNS only (grey cloud), not proxied.
If Flowcode Support gave you a TXT record, it's published with the exact name and value they sent.
Note: DNS changes can take 24 to 48 hours to apply.
Validate again
On the Domains tab, click ⋮ on the domain's row.
Click Validate.
Within a few minutes, the status changes from Pending to Active and you see "<your domain> is validated".
If the domain isn't Active, you see "<your domain> is pending validation. Please confirm DNS configuration and revalidate." That message appears for every status other than Active, including Moved and Deleted.
Note: Validation isn't automatic. Click Validate each time you fix your DNS records.
Troubleshooting
"My domain is stuck on Pending."
Check your CNAME or A and AAAA records, allow up to 48 hours for DNS, then click Validate again. If the records are correct and it's still Pending, contact Flowcode Support at [email protected] with the hostname. If the ownership check fails, for example because you run your own proxy or firewall in front of the domain, Support sends a TXT record name and value. Add it exactly as given, then click Validate.
"My domain shows Moved."
Validate won't fix a Moved domain. Fix your DNS records, then contact Flowcode Support at [email protected] to reset it. Next time, set up DNS before you add the domain, or right after.
"My domain shows Deleted."
You can't recover a Deleted domain yourself. Contact Flowcode Support at [email protected] with the hostname. Support deletes and re-adds it.
"I get an error that the hostname already exists or is a duplicate when I click Create."
That hostname is already registered with Flowcode, from an earlier attempt or in another organization. A hostname can be registered once across all organizations. Add a different hostname, such as go.example.com, or contact Flowcode Support at [email protected] if you need the original.
"I added the wrong domain, or typed it with a space or https://."
Contact Flowcode Support at [email protected] to remove it, then add the hostname again with no https://, trailing slash, or dot. Flowcode now removes stray spaces automatically. For a flow on a domain that was saved with a space, open the flow's Settings, switch Domain to the default and back, and publish. Codes already printed with the space still don't work.
FAQs
Can I delete or edit a custom domain myself?
No. Contact Flowcode Support at [email protected] to remove it, then add the correct hostname.
Can I see the ownership TXT record in Flowcode?
No. Flowcode Support sends its exact name and value for your hostname, and only when the ownership check fails.
Can I move a domain to another organization?
No. Add a different hostname in the other organization.
Can I use a hostname that serves Flowcode 1 codes?
No. One hostname can't serve both Flowcode 1 and Flowcode 2. Use a new one, and leave the Flowcode 1 records unchanged. A subdomain with a CNAME record is the most reliable choice.
Will my existing flows switch to the domain once it's Active?
No. A flow keeps the domain it was created with. Change Domain in the flow's Settings before you print its codes. For a flow whose codes are already in use, click Make a copy and set the domain on the copy.