Skip to main content

Custom domain - Set up a custom domain for your QR codes and short URLs

Add your own domain or subdomain to Flowcode, validate it, and use it on your flows' QR codes and short URLs.

User Permissions

Organization Admins add and validate domains.
Workspace Admins can make an Active domain the workspace default.

Note: Available with Flowcode 2. If you don't see Organization admin, ask an Organization Admin.

Choose a hostname

Your hostname replaces the default domain (usually flowsto.com) in your QR code and short URL links. (Older articles say "FlowURLs".)

  • Use a subdomain such as qr.example.com where you can. It can use a CNAME record, which keeps working if Flowcode's addresses change.

  • A root domain such as example.com also works, but needs A and AAAA records.

  • Use a new hostname. One hostname can't serve both Flowcode 1 and Flowcode 2. Leave your Flowcode 1 records unchanged. Reusing a Flowcode 1 hostname breaks its Flowcode 1 codes.

Point your DNS at Flowcode

  1. At the top right of any page, click Organization admin.

  2. At the bottom left, click Settings.

  3. Click the Domains tab.

  4. Click Create domain. The Add a Custom Domain window opens. Keep it open.

  5. With your DNS provider, add one record for your hostname:

    • Subdomain (recommended): a CNAME record pointing to whitelabel.flowsto.com.

    • Root domain: A records for the 2 IPv4 addresses and AAAA records for the 2 IPv6 addresses listed in the window. Copy them from the window.

  6. Delete any other A, AAAA, or CNAME records for that hostname.

  7. If your DNS is hosted on Cloudflare, set every record to DNS only (grey cloud), not proxied.

The Domains tab in Organization settings with the Create domain button, numbered 3 and 4

The Add a Custom Domain window listing 2 IPv4 and 2 IPv6 addresses, numbered 5

Note: The window lists only IP addresses. For a subdomain, a CNAME record to whitelabel.flowsto.com also works.

Add and validate the domain

  1. In Domain, enter the hostname only, such as qr.example.com. Leave out https://, slashes, and a trailing dot.

  2. (Optional) In Description, enter a note. It shows under the domain name.

  3. Click Create. The domain shows as Pending ("Please add the domain to your DNS configuration").

  4. Wait for DNS to update. It can take 24 to 48 hours. Validation isn't automatic.

  5. Click ⋮ on the domain's row, then click Validate.

The Add a Custom Domain window with an example hostname, a description, and the Create button, numbered 1 to 3

The menu on a domain's row in the Domains tab with Validate, numbered 5

Within a few minutes of clicking Validate, the status changes from Pending to Active and you see "<your domain> is validated". Flowcode issues the SSL certificate in about 15 minutes. The domain then appears in the flow Domain list.

Important: Add your DNS records within a day or two of clicking Create. Otherwise the status changes to Moved and only Flowcode Support can reset it.

Use the domain on your flows

  • Workspace default: a workspace Admin sets it.

    • In the left sidebar, click Manage, then click the Domains tab.

    • Click ⋮ on an Active domain, then click Set as default.

    • The domain gets a Workspace default badge and is preselected for new flows.

  • New flow: select the domain in Domain when you create the flow.

  • Flow that isn't printed yet: in the Flow Editor, click Settings (gear icon), change Domain, and publish.

The Domains tab in Manage workspace with Set as default in a domain's menu

The flow Settings window opened from the gear icon, with the Domain dropdown

Once a flow uses the domain, its QR codes and short URLs use your hostname.

Important: Choose the domain before you print. Changing a published flow's domain breaks its codes and short URLs already in use. To move a live flow to a new domain, use Make a copy and set the domain on the copy.

Troubleshooting

"I get '<domain> is pending validation. Please confirm DNS configuration and revalidate.'"
Your DNS records are missing, wrong, or not updated yet. Fix them and click Validate again. See Custom domain - Fix a domain that won't validate, which also covers Moved and Deleted.

"My domain isn't in the Domain list when I create a flow."
Only Active domains are listed. If the workspace shows "No domains are currently set up for this workspace", an Organization Admin needs to add one.

"The Domain field says 'Domain selection unavailable' or 'No OneTrust-enabled domains available'."
Your organization requires cookie consent, so flows can only use a custom domain with a consent policy. An Organization Admin opens Organization admin → Settings → Cookie consent → Create consent policy for an Active custom domain. The Cookie consent tab appears only for organizations whose data processing agreement with Flowcode is on file. If you don't see it, contact your Flowcode CSM.

"I see 'Changing the domain of this flow will break any Flowcodes or Short URLs that are already in use.'"
Keep the current domain on flows with printed codes. To use a new domain, click Make a copy on the flow, change Domain on the copy, and print the copy's codes.

"I get an error that the hostname already exists or is a duplicate."
A hostname can be registered once across all Flowcode organizations. Add a different one, such as go.example.com.

FAQs

Can I delete, rename, or edit a custom domain?
No. Contact Flowcode Support at [email protected] to remove one, then add the correct hostname.

Can I move a domain to another organization?
No. Add a different hostname in the other organization.

Related articles

Did this answer your question?