🌐 Overview
Setting up Search Atlas white labeling with a custom domain involves three moving parts: your Cloudflare DNS record, the Search Atlas white label configuration, and any third-party integrations such as GoHighLevel (GHL) blogs or the WordPress plugin. A misconfiguration in any one of these areas can cause broken dashboard URLs or content display issues. This guide walks you through each step in the correct order.
⚙️ Step 1: Configure Your White Label Domain in Search Atlas
Before touching DNS, make sure your custom domain is registered inside Search Atlas.
- Log in to your Search Atlas account and navigate to Settings → White Label.
- Enter your chosen subdomain (e.g., app.youragency.com) in the custom domain field.
- Save the settings. Search Atlas will display the CNAME target value you need for the next step. Copy this value exactly — do not modify it.
Important: Complete this step first. Creating the DNS record before registering the domain in Search Atlas is a common cause of mismatches that break the dashboard URL.
☁️ Step 2: Add the CNAME Record in Cloudflare
- Log in to Cloudflare and select the domain you are using for white labeling.
- Go to DNS → Records and click Add record.
- Set the record type to CNAME.
- In the Name field, enter only the subdomain prefix (e.g., app if your full subdomain is app.youragency.com).
- In the Target field, paste the CNAME value copied from Search Atlas.
- Set Proxy status to DNS only (grey cloud). Enabling the Cloudflare proxy (orange cloud) on this record is the most frequent cause of broken dashboard URLs because it intercepts SSL termination handled by Search Atlas.
- Click Save.
DNS propagation typically takes 5–30 minutes, but can take up to 48 hours in some regions. Use a tool such as dnschecker.org to confirm the CNAME is resolving correctly before proceeding.
🔌 Step 3: Fix the WordPress Plugin Dashboard URL
If you added the DNS record after the WordPress plugin was already installed, the plugin may still be pointing to the original Search Atlas dashboard URL instead of your white label domain.
- In your WordPress admin panel, go to Search Atlas → Settings.
- Locate the Dashboard URL or API Endpoint field.
- Replace the existing URL with your new white label domain (e.g., https://app.youragency.com).
- Save changes and reload the plugin page to confirm the connection is successful.
If the field is greyed out or the plugin re-populates the old URL automatically, deactivate and reactivate the plugin after updating the URL, then save again.
📝 Step 4: Fix Missing Tables in GHL Blog Posts
GoHighLevel's blog editor strips certain HTML elements — including table tags — when content is pasted or imported. This is a known GHL editor limitation, not a Search Atlas issue.
Use one of the following workarounds to display tabular data correctly:
- Convert tables to styled lists or columns: Recreate the table content using GHL's native column blocks or bullet lists so the editor does not strip the markup.
- Embed an HTML block: In the GHL blog editor, insert a Custom Code / HTML block and paste your raw table HTML directly into it. This bypasses the editor's sanitisation and renders the table as intended.
- Use an image: For purely visual tables (non-interactive data), export the table as an image and insert it via GHL's image block.
Recommended approach: The HTML block method preserves full formatting and is the most reliable option for complex tables.
✅ Quick Troubleshooting Checklist
- Dashboard URL broken after DNS change? Confirm the CNAME proxy is set to DNS only in Cloudflare and that the target matches the value in Search Atlas Settings.
- WordPress plugin connecting to wrong URL? Manually update the Dashboard URL field in the plugin settings to your white label domain.
- SSL certificate errors on white label domain? Wait up to 30 minutes after DNS propagation for the certificate to provision automatically. Do not enable the Cloudflare proxy during this window.
- Tables still not showing in GHL? Switch to an HTML block and paste the raw table markup directly.
💬 Need More Help?
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.