## **🔍 Why Your White-Label Domain Is Not Working**

If you visit your white-label agency domain and see a message like **"Looks like the page you're trying to access does not exist"**, the most common cause is an incomplete or incorrect DNS configuration. Your custom domain needs to point to Search Atlas servers before the white-label preview can load correctly. This guide walks you through every step to get your domain live.

## **📋 What You Need Before You Start**

- Admin access to your domain registrar (e.g., GoDaddy, Namecheap, Cloudflare)
- Your white-label subdomain chosen and entered inside Search Atlas (e.g., **reports.youragency.com**)
- Admin access to your GoHighLevel account if you are routing through a GoHighLevel sub-account
- A few minutes of patience — DNS changes can take up to 48 hours to fully propagate

## **⚙️ Step 1: Confirm Your White-Label Domain in Search Atlas**

1. Log in to Search Atlas and navigate to your **Agency Settings** or **White-Label** configuration panel.
2. Confirm the exact subdomain you have entered (e.g., **reports.youragency.com**). Copy it exactly — spelling and punctuation matter.
3. Note the **CNAME target value** displayed on that page. You will need this in the next step. It typically looks like **whitelabel.dns.searchatlas.com** or similar.

## **🛠️ Step 2: Add the CNAME Record at Your Domain Registrar**

1. Log in to the control panel of the registrar where your domain is registered.
2. Go to **DNS Management** or **DNS Records** for your domain.
3. Create a new **CNAME** record with these values:

   - **Host / Name:** the subdomain prefix only (e.g., **reports** if your full subdomain is reports.youragency.com)
   - **Value / Points to:** the CNAME target value copied from Search Atlas in Step 1
   - **TTL:** 3600 (1 hour) or the lowest value your registrar allows
4. Save the record.

**Important:** If you already have an A record or conflicting CNAME for the same subdomain, delete it before adding the new CNAME record. Conflicting records will prevent the domain from resolving correctly.

## **🔗 Step 3: Configure the Domain Inside GoHighLevel**

If you are using GoHighLevel to host client portals or route traffic through a sub-account, you must also register the custom domain inside GoHighLevel so the two platforms can communicate correctly.

1. Log in to GoHighLevel and open the relevant **Sub-Account**.
2. Go to **Settings → Domains**.
3. Click **Add Domain** and enter the same subdomain you configured in Search Atlas (e.g., **reports.youragency.com**).
4. GoHighLevel will verify the domain by checking the CNAME record you added in Step 2. Verification may take a few minutes.
5. Once verified, set this domain as the **primary domain** for the sub-account if you want all white-label report links to use it.

**Note:** If GoHighLevel shows a verification error immediately after you add the CNAME record, wait 15–30 minutes and try verifying again. DNS changes are not always instant.

## **✅ Step 4: Test and Verify Your White-Label Domain**

1. Open a private or incognito browser window to avoid cached results.
2. Type your full white-label subdomain into the address bar and press Enter.
3. You should see your branded Search Atlas report portal instead of the error page.
4. If the error persists, use a free DNS checker tool (such as **dnschecker.org**) to confirm your CNAME record has propagated globally. Enter your subdomain, select CNAME as the record type, and check that results point to the correct Search Atlas target.

## **⏱️ DNS Propagation: What to Expect**

DNS changes do not apply instantly. Propagation typically takes **15 minutes to 4 hours** for most regions, but can take up to **48 hours** in rare cases depending on your registrar and TTL settings. During this window, some locations may still see the error page while others load correctly — this is normal. Avoid making further DNS changes during this period as it can restart the propagation timer.

## **🚨 Common Mistakes to Avoid**

- **Using the full domain as the Host value** — enter only the subdomain prefix (e.g., **reports**, not reports.youragency.com) unless your registrar specifically requires the full domain.
- **Skipping the GoHighLevel domain step** — configuring DNS alone is not enough if you use GoHighLevel; both platforms must recognise the domain.
- **Cloudflare proxy enabled** — if your domain is managed through Cloudflare, make sure the CNAME record is set to **DNS only** (grey cloud icon), not proxied (orange cloud). The Search Atlas white-label integration requires direct DNS resolution.
- **Testing too soon** — always test in a private window after waiting at least 15 minutes.

## **💬 Still Seeing the Error?**

If you have followed all the steps above and your white-label domain is still not loading correctly, If you need further assistance, open the chat widget in the bottom-right corner of the platform and type **human teammate** to be connected with a member of our team.