Instead of using our heyflow.id domain to share your heyflow, you can also connect your own (sub-) domain with Heyflow.
In this article, you will learn how to connect your own domain to your Heyflow in just a few steps and receive troubleshooting tips.
💡 Tip: Your own domain generates more trust among visitors to your flow.
🔎 You can use your heyflow in many ways, one being standalone as an own page with a domain. If you’d rather want to use your heyflow embedded as an element on your website, learn here how to embed your heyflow.
Setup
🔎 Before we start, you need two things:
A published heyflow
Access to the DNS settings of your domain
1. Set up domain in Heyflow
Navigate to your heyflow > Integrate > Domains. On this page, click Add domain, enter your domain (without https://) and finally, click Add.
A new element appears with a domain setup badge. Keep this page open – we need the values in a second.
2. Set CNAME record for the domain
Open a new tab or window and navigate to your DNS settings with your domain provider (we're showing Namecheap in this guide).
On this page, enter the data as it was shown in Heyflow. The type of the record is CNAME, the host is your (sub-) domain and the value is flow.heyflow.domains. The TTL is Automatic.
Some providers use other names for the columns, but should always be similar.
3. Connect domain in Heyflow
Lastly, return to your Heyflow domain connection and click the blue Connect button.
Then, the domain status changes to Pending. Hit refresh and see if the status updates. It usually takes a while for the CNAME to propagate.
❗ If it's not connecting immediately, try after a few more minutes or hours. It can take up to 24 hours, but usually, it's much faster.
If your CNAME is correctly set, after another refresh, the domain status switches to Connected and you have successfully connected your domain.
With the little arrow icon at the top right, you can visit your connected page via the domain.
After the status changes to Connected, it can take another few minutes for the security certificate (HTTPS/SSL/TLS) to show up. Reload our page after just a few minutes.
Troubleshooting
I want to connect a root domain (without a subdomain).
To show a heyflow on a root domain, e.g. heyflow.so, first, you can try to set up a CNAME on that domain, using an @ as the host. However, some providers don't support CNAME records on root level. In that case, you need to set up a subdomain, e.g. www, and redirect your root domain there.
I connected my heyflow, but I still can't see the heyflow under the domain
This can be for many reasons, unfortunately.
Make sure you have published your heyflow.
Make sure the domain you're trying to connect does not point to any other service: Remove all other A, AAAA, and CNAME records for that (sub-) domain.
You can get some more information about the current DNS settings with tools like NsLookup.io.
My provider doesn't let me insert the CNAME
Some providers, such as Wix, state the CNAME flow.heyflow.domains. is being invalid. In this case, simply try without . in the end.
My SSL certificate isn’t being created
A missing SSL certificate can have different reasons, it can take some time to be created. But if you have a CCA record in your DNS settings that prohibits certificate creation by Google, the SSL certificate can’t be created. This can be the case If you’re using e.g. Hostinger as a provider. Please remove all CAA records or add records for this authority (pki.goog). Take a look here for more information.
My provider doesn't let me set TTL to automatic
Some providers, such as Wix, do not have the option to set TTL (time to live) to automatic. Don't worry, you can also set TTL at 24 hours, depending on the frequency of which your records need to be updated.
My domain name is invalid
Due to special characters (ä, é, ß), an error can occur when trying to connect your domain to your flow.
You can use a workaround by inserting a special encoded URL using punycode. The flow will then be available under your desired domain.
Example: If you want to connect tästing.com, simply insert the punycode URL xn--tsting-bua.com and the domain can be connected:
💬 If you're having any other issues, please contact the support.