🔍 Overview
Custom JavaScript added through your site's custom code settings should appear in your live site's page source after publishing. If your code is not showing up, a few common causes are usually responsible. This article walks you through general troubleshooting steps to try before escalating to the support team.
✅ Step 1: Confirm the Code Was Saved and Published
The most frequent cause of missing custom code is an incomplete save or publish action.
- Navigate to the custom code or custom scripts section of your platform dashboard.
- Verify your JavaScript code is present in the correct field.
- Save any unsaved changes.
- Publish or apply the changes to push them to your live site.
- Wait 1–2 minutes, then hard-refresh your live site (Ctrl + Shift + R on Windows or Cmd + Shift + R on Mac) and check the page source again.
🗄️ Step 2: Clear Your Cache
Caching at multiple levels — browser, server, or CDN — can prevent updated code from appearing immediately in your live site source.
- Browser cache: Perform a hard refresh as described above, or open your site in a private/incognito window.
- Server or CDN cache: If your site uses a CDN (such as Cloudflare) or a server-level caching plugin, purge the cache from that service's dashboard and check again.
- Platform cache: If your Search Atlas-connected site has a caching layer, clear it and re-check the live source.
📋 Step 3: Check That Your Code Is Valid JavaScript
Invalid or malformed JavaScript can cause the code block to be stripped or silently ignored during publishing.
- Make sure your code does not contain unclosed tags, mismatched brackets, or syntax errors.
- If you are embedding a third-party script, ensure you are pasting the full snippet exactly as provided, including any required opening and closing
<script>tags. - Test your snippet in a JavaScript validator or your browser's developer console before adding it to the platform.
🔒 Step 4: Check for Security or Content Policy Restrictions
Some hosting environments and security configurations block the injection of inline scripts or scripts from external domains. This is enforced by the server or CDN — not by Search Atlas — and can silently prevent custom code from rendering.
- Review your site's Content Security Policy (CSP) headers to confirm external script sources are allowed.
- If you are using a security plugin or firewall (such as Wordfence or Sucuri), check whether it is filtering custom script injections.
- Contact your hosting provider if you suspect server-level policies are blocking the code.
📩 Still Not Showing? Escalate to Support
If you have worked through the steps above and your custom JavaScript is still not appearing in your live site source, the issue may require investigation by the Search Atlas team. To help us resolve it quickly, please have the following ready before reaching out:
- The exact JavaScript snippet you are trying to add.
- The URL of the live page where the code should appear.
- A description of which step you completed and what result you observed.
- Any error messages shown in your browser's developer console (right-click the page → Inspect → Console tab).
- The timestamp of when you last saved and published your changes.
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.