Custom domain stuck on Pending or Failed
You added a custom domain to your page, and its status badge in the custom domain dialog shows Pending, Failed or Expired instead of Verified. In almost every case, the DNS record at your domain registrar is missing, wrong, or hasn't taken effect yet.
Symptom
Each domain in the dialog shows one of four status badges:
- Pending: we're still waiting to see the right DNS record for your domain.
- Failed: we checked and couldn't verify the domain.
- Expired: the verification didn't complete and is no longer valid.
- Verified: everything is working. Nothing to fix.
If you see a message saying custom domains are available for Pro users only, your workspace is on the free plan. Upgrade from your billing settings, then add the domain.
Common causes
The DNS record is missing or wrong
This is the most common cause. After you add a domain, the dialog lists the DNS records you need to create at your registrar. Each record has a type, a name and a value. Typical mistakes:
- The record was never created at the registrar.
- The name or value was retyped by hand and has a typo, or an extra space.
- The record was created at a different DNS provider than the one your domain actually uses.
- An old record for the same name still points somewhere else.
You added a root (apex) domain
A root domain is one with no subdomain in front, like example.com. The record we give you is a CNAME, and a CNAME can't be set on a root domain. Most registrars refuse to save it, so nothing ever resolves and the status never moves past Pending.
If you entered something like example.com, the dialog warns you about this.
The record is right but hasn't propagated yet
DNS changes aren't always visible everywhere straight away. If you created the record recently, the domain can stay on Pending until the change spreads. The time this takes depends on your registrar and DNS provider.
Fix
1. Recheck the records at your registrar
- Open the custom domain dialog for your page and find your domain in the list.
- Use the copy button next to each DNS record to copy its value exactly.
- Sign in at your registrar (or wherever your DNS is managed) and open the DNS settings for the domain.
- Compare each record with the one in the dialog. Check the type, the name and the value. Fix anything that differs and delete any older record for the same name that points elsewhere.
- Save your changes.
2. If you used a root domain, switch to a subdomain
Because we only provide a CNAME record, use a subdomain instead, such as www.example.com or pages.example.com.
- In the dialog, remove the root domain. You'll be asked to confirm that you want to remove it.
- Add the subdomain under Add Custom Domain.
- Create the DNS records shown for the new hostname at your registrar.
3. Wait for propagation, then check the status
- Give your DNS provider some time to publish the change.
- Reopen the dialog. When you open it, we automatically re-check any domain that hasn't been checked in the last hour.
- To check right away, click Check Status next to the domain. A "Status updated" message appears when the check finishes.
4. Re-add the domain if it still shows Failed or Expired
If the records are correct and enough time has passed but the status hasn't changed, start the verification over:
- Remove the domain in the dialog.
- Confirm that the DNS records at your registrar match what you're about to be given.
- Add the domain again and create any new records the dialog shows.
- Wait for DNS to update, then click Check Status.
A domain that was Verified but stopped working
A domain can stay marked Verified after its DNS is later changed. The dialog shows a warning when a domain isn't serving, for example:
- The domain has no DNS record pointing at us right now.
- The domain's DNS record points somewhere else.
- We can reach the DNS record, but the site isn't loading.
- The SSL certificate couldn't be issued or has expired.
For the first two, restore the DNS record shown in the dialog at your registrar, then click Check Status.
When to contact support
Contact support if:
- Your records match the dialog exactly and the domain is still not verified after you've waited and re-added it.
- You see an SSL certificate warning that doesn't clear after your DNS is correct.
- You get an error when adding or removing a domain.
Include the domain name, the status shown, and a screenshot of the DNS records at your registrar.
Did this answer your question?
Your feedback helps us improve.
