Skip to main content
When you add a custom domain to Laravel Cloud, Cloud needs to confirm that you own the domain and that your DNS records are set up correctly. This process is called verification. Occasionally, verification may appear stuck or time out entirely. This is usually because a DNS record is misconfigured or has not finished propagating (the process by which DNS changes spread across the internet).

​
Before you start

Add your records at the provider that actually serves DNS for your domain, which is not always where you purchased it. For example, if you registered at GoDaddy but pointed your nameservers to Cloudflare, you must add records in Cloudflare. Run the following command to check:
The output will list nameserver hostnames (e.g., anna.ns.cloudflare.com). Add your Laravel Cloud records at the provider that owns those nameservers.

​
Add your DNS records

Add all records Laravel Cloud shows, including www and wildcard records if they are enabled. If you chose pre-verification (proving ownership and issuing the SSL certificate before switching traffic), Cloud also shows an ownership verification record and SSL validation records. Record names and values must match exactly; even small differences, such as extra dots or missing prefixes, will cause verification to fail.

​
Enter only the subdomain

Most DNS providers have a host or name field that expects only the subdomain portion of a record name, not the full domain. Your provider appends the domain automatically:
  • For www.example.com, enter www
  • For _cf-custom-hostname.example.com, enter _cf-custom-hostname
  • For _acme-challenge.example.com, enter _acme-challenge
  • For example.com itself, most providers use @ or leave the host blank
If you paste the full name into this field, the domain is added twice, producing _cf-custom-hostname.example.com.example.com instead of _cf-custom-hostname.example.com. After saving a record, always re-open it in your provider’s dashboard and confirm the assembled name matches exactly what Laravel Cloud shows. This is the most effective way to catch formatting mistakes early.

​
Domain control validation records

Some domains need a domain control validation (DCV) delegation record: a CNAME named _acme-challenge that points to Cloudflare, which Laravel Cloud uses to issue and renew your SSL certificates. Laravel Cloud shows this record when:
  • The domain is a wildcard domain (such as *.example.com), or belongs to a domain with a wildcard enabled, including its www domain
  • You chose Cloudflare DNS and Proxy for the domain, because your Cloudflare proxy would otherwise answer certificate validation requests before they reach Laravel Cloud
Add the record at your DNS provider like any other record, and keep it in place after verification. Removing it prevents your certificate from renewing.

​
Provider-specific instructions

1

Open your domain in Cloudflare

In Cloudflare, select your website and open DNS. Confirm you are editing DNS records in the correct Cloudflare account and zone.
2

Add the origin record(s) from Laravel Cloud

In Laravel Cloud, open your domain’s configuration and copy the origin record(s). These records tell Cloudflare where to send traffic for your domain.For the record name in Cloudflare:
  • Use @ for the root domain (e.g., example.com)
  • Use www for www.example.com
  • Use * for *.example.com (wildcards), if shown
For proxy status (the orange or gray cloud icon in Cloudflare):
  • Origin records are typically safe to proxy (orange cloud) if you selected a Cloudflare proxy option in Laravel Cloud.
  • If you are unsure, start with the proxy status Laravel Cloud recommends in the UI.
3

Add the pre-verification TXT record (if shown)

If Laravel Cloud shows an ownership verification record like _cf-custom-hostname.example.com, add it as a TXT record named _cf-custom-hostname.
4

Add SSL validation records (if shown)

Laravel Cloud may show _acme-challenge records used to issue your domain’s SSL certificate. Copy them exactly as shown.If an _acme-challenge record is a CNAME, such as a DCV delegation record, keep it set to DNS only (gray cloud) at all times. Proxying it will prevent the SSL certificate from being issued or renewed.
If you are pre-verifying your domain and see Cloudflare-related verification errors, temporarily setting the hostname’s record to DNS only may be required until verification completes. You can re-enable the proxy afterward.
Unlike most providers, Route 53 accepts fully qualified record names, so you can paste the complete name from Laravel Cloud (e.g., _cf-custom-hostname.example.com) directly into the name field. Route 53 may add a trailing dot (e.g., _cf-custom-hostname.example.com.), which is standard DNS formatting and is expected.If you are not sure you are editing the correct hosted zone, confirm that the nameservers from the dig NS check match the nameservers listed in your Route 53 hosted zone.
GoDaddy’s DNS editor calls the subdomain field Host. After saving, GoDaddy displays the full record name, so you can confirm there that it matches Laravel Cloud exactly, with no repeated or missing parts.
Namecheap’s DNS editor calls the subdomain field Host. For root-domain records (i.e., records for example.com itself), use @ as the host value.
Squarespace (which acquired Google Domains) has its own naming conventions, but the subdomain rule applies to any name or host field. For a wildcard *.example.com, enter *.

​
Verification timeline

Most domains verify within 15 minutes once the correct DNS records are publicly visible. However, propagation can take longer depending on your DNS provider and the record’s TTL (time-to-live), a value that controls how long DNS results are cached before being refreshed. Laravel Cloud will automatically retry verification checks for approximately 12 hours. If verification still cannot complete after that period, the domain will time out and you may need to correct your DNS records and retry.

​
Check your records in the terminal

You can verify that your DNS records are publicly visible by running dig commands in your terminal. Replace example.com with your actual domain:
If any command returns no output, that record is either missing or has not finished propagating.

​
Common verification issues

​
Missing www records when redirects are enabled

Laravel Cloud’s Redirect from www. setting is enabled by default and is the recommended configuration. When enabled, Laravel Cloud will validate both example.com and www.example.com, which means DNS records are required for both hostnames. If you only added records for example.com and skipped www, verification can fail. Make sure you added records for both hostnames exactly as shown in the domain configuration screen.

​
Records have propagated but the domain is still verifying

If your records look correct when checked with dig or an external DNS tool, but the domain is still showing as Verifying or Timed out in Laravel Cloud, this may indicate that our network provider (Cloudflare) has flagged the domain for manual review. This can happen even if your domain is not hosted on Cloudflare, because Laravel Cloud uses Cloudflare’s infrastructure behind the scenes to manage SSL certificates and routing. Cloudflare’s automated systems occasionally flag domains due to potential abuse concerns. This is sometimes a false positive and requires intervention on the Cloudflare side to resolve. If you believe this is affecting your domain, contact support so the team can assist.

​
When to contact support

If your domain is still stuck after working through this guide, contact support through the Help portal in your Laravel Cloud dashboard. To help the team diagnose the issue quickly, include: