To connect your custom domain, you'll need to create two DNS records. These records typically look like this:
But before we dive in, let's cover some basics. The DNS CNAME record is like a virtual pointer, allowing one domain to alias another. This is especially handy when you want to direct a subdomain to another domain.
Root Domain Consideration:
Using your root domain (e.g., yourdomain.com) as the White Label (WL) domain requires CNAME flattening.
If your DNS provider supports CNAME flattening, ALIAS, or ANAME records, fantastic! You can seamlessly connect your White Label to your root domain.
The following DNS providers support pointing root domains to a CNAME/ANAME/ALIAS record:
Don't see your provider on the list? No worries! You can still connect your root account to White Label by migrating your DNS management to one of the providers mentioned above.
Please reach out to our support if you need assistance with this migration process.
Setting Up CNAME Records
Here's a step-by-step guide for the most popular DNS providers or follow the general flow:
Step 1: Log in to Your Domain Registrar
Your domain registrar is where you bought your domain. Log in to your account on their website.
Step 2: Find DNS Settings
Look for options like "Domain Management" or "DNS Settings."
Step 3: Locate the CNAME Section
Find the section related to CNAME records. It might be labeled as "CNAME," "Alias," or "Canonical Name."
Step 4: Add a New CNAME Record
Provide the subdomain and the domain you want it to point to. Save your changes.
Step 5: Verify the CNAME Record
Verification might take time due to DNS propagation. Use tools like "NsLookup" to ensure the values match.
Step 6: Troubleshooting Tips
Clear browser cache, check spelling, and review common issues like typos or duplicating the root domain.
Troubleshooting Tips
Clear Browser Cache: Sometimes, browsers cache old DNS information. Clear your cache or try a different browser.
Check Spelling: Ensure there are no typos in the domain names.
Common Issues: Double-check the value for the subdomain.
Certification Authority Authorization (CAA) Records: If you encounter issues related to CAA records, follow our guide to add the necessary DNS records. If you face difficulties, our support team is here to assist you.
Common Issues and How to Fix Them
1. The wrong value for Name/Host/Alias was set:
Sometimes, the wrong values are set for Name/Host/Alias. It's like finding the perfect address for your subdomain. Make sure you're not pasting the full domain when the dashboard only needs the subdomain. Example: "app.yourdomain.com" is correct; "app.yourdomain.com.yourdomain.com" is not.
2. Certification Authority Authorization (CAA) Not Allowed:
If you're not seeing two CNAME records in your WL page or getting an error message about domain restrictions such as “You are not allowed to set such domain here, as a fraud-protection measure”, you might have CAA records in your DNS settings. CAA records control who can issue TLS certificates for your domain. We use AWS Certificate Manager (ACM) for your White Label Site's certificates.
To allow AWS to work its magic, add the following DNS records:
Domain | Record type | Flags | Tag | Value |
@ | CAA | 0 | issue | amazon.com |
@ | CAA | 0 | issue | amazon.com |
@ | CAA | 0 | issue | amazon.com |
@ | CAA | 0 | issue | amazon.com |
⚠️ After adding these records, give it a few hours. Then, restart your WL setup from scratch. Remove the value for your domain, apply it again, and voila! You should see two CNAME records in place on your WL page. Follow the usual WL domain setup steps from the beginning of this guide.
If you have any questions, don't hesitate to contact our customer support team available 24/7 using the chat bubble on your screen, or email us at [email protected].
We're here to provide personalized guidance based on your domain registrar platform and settings. Connecting your custom domain should be a smooth and stress-free experience, and we're here to ensure that happens!