Flowcode 2 supports custom domains, giving your brand complete control over the URLs associated with your QR codes and Short URLs. This is essential because your custom domain will be visible to users upon scanning or clicking, ensuring a fully branded and consistent experience at every touchpoint. This powerful feature allows you to offer short, memorable links while maintaining brand continuity.
This guide outlines the straightforward process for setting up a custom domain within the Flowcode 2 platform.
What You’ll Need Before You Start
To ensure a smooth and successful setup, please gather the necessary technical and administrative components outlined below before beginning the configuration process.
Access to your DNS provider for the domain (Cloudflare, GoDaddy, Route53, Namecheap, etc.)
Access to Flowcode organization admin (to add + validate the domain and trigger SSL issuance)
[PLEASE NOTE] If your direct access is limited, coordinating with your Flowcode Advanced Builder point of contact for platform access and necessary information is a fully supported approach.
A decision on the hostname you want to use:
Recommended: a subdomain of your existing domain (e.g. something like qr.example.com that we will use in these instructions)
Important Notes
We recommend utilizing a subdomain for your custom domain setup (using a CNAME record). This approach is preferred as it minimizes potential conflicts with your main website. The remainder of this guide focuses specifically on the steps required for subdomain configuration. Before proceeding, please review these key call-outs:
CAA records (SSL): If your domain uses DNS CAA records, ensure they allow the certificate authority used by Flowcode for SSL issuance. If you’re unsure, contact Flowcode Support for the correct CAA values.
Adding your custom domain in Flowcode:
When adding custom domains in your Flowcode account, enter only the hostname, e.g. qr.example.com(no https://).
Do not add a trailing dot when adding custom domains (e.g. use qr.example.com, not qr.example.com.).
Record conflicts:
A standard CNAME must be the only non-DNSSEC record at that hostname.
At the apex (@), most providers do not allow a standard CNAME; use ALIAS/ANAME/flattening or A/AAAA.
Step-by-Step Instructions: Custom Subdomain Setup
To ensure clarity throughout the setup process, please note that all instructions will reference the following example domain structure:
We will use qr.example.com, where:
qr = the subdomain prefix
example.com = your registered domain
Please substitute these values with your brand's specific domain information as you proceed through the steps:
Log in to your DNS provider and open DNS management for example.com.
Create a CNAME record
Type: CNAME
Name/Host: qr (some providers accept/require qr.example.com; either is fine as long as the record created is for qr.example.com)
Target/Value/Points to: whitelabel.flowsto.com
TTL: Auto / Default
Remove conflicting records (if they exist)
Delete any A/AAAA records for qr.example.com.
If qr.example.com already has a CNAME, replace it with the Flowcode target.
Save the DNS changes.
Add the domain in Flowcode
In Flowcode organization admin, add the custom domain: qr.example.com
Validate in Flowcode
Use the validation action (in the ellipsis menu of the custom domain).
If validation fails immediately, wait a bit and retry.
Propagation expectations
DNS changes usually resolve in minutes but may take up to 24–48 hours due to TTL and resolver caching.
Success State:
When the setup is complete, your custom domain will meet the following criteria:
Validation: The custom domain status will display as Validated within your Flowcode settings.
Security: The domain will load securely over HTTPS, ensuring no certificate warnings are shown to end-users.
Branding: When users scan a Flowcode or click a short URL, the link will begin with your custom domain (e.g., https://qr.example.com/).