🔍 Overview
If OTTO is not detecting the pixel on your Magento 2 website — even after placing the code in your theme header — this guide walks you through the most common causes and how to fix them. Follow each step in order before moving to the next.
⚙️ How OTTO Pixel Installation Works
OTTO requires a small JavaScript pixel to be present in the <head> section of every page on your website. Once detected, OTTO can activate automated on-page SEO improvements across your site. On Magento 2, several platform-specific factors can prevent the pixel from being recognised even when the code appears to be in place.
✅ Step-by-Step Troubleshooting
- Confirm the correct pixel code is being used. Log in to Search Atlas and locate your OTTO pixel snippet. Do not reuse a snippet from a previous session — it may have changed.
- Place the pixel in the correct Magento 2 location. The pixel code must be added to the
<head>section of your Magento 2 theme so it loads on every page. Consult your developer or your theme documentation for the appropriate method to inject a script into the page head for your specific Magento 2 setup. After saving, flush your Magento cache to ensure the change takes effect. - Check that full-page cache is cleared. Magento 2 uses aggressive full-page caching. After saving your changes, ensure you clear all relevant caches — including any full-page cache and, if applicable, any reverse-proxy cache such as Varnish.
- Verify the pixel renders in your page source. Open your website in a browser, right-click anywhere on the page, and select View Page Source. Use Ctrl+F (or Cmd+F on Mac) to search for your OTTO pixel ID or the pixel script tag. If it is not present, the code was not saved correctly — repeat the previous step.
- Check whether JavaScript bundling or minification is interfering. Magento 2's built-in JS bundling and minification can sometimes interfere with inline scripts. If you suspect this is the cause, consult your developer about temporarily disabling these optimisations to confirm whether they are blocking pixel detection.
- Check for a Content Security Policy (CSP) blocking the pixel. Magento 2.4+ enforces strict Content Security Policies by default. If your browser console shows a CSP error related to the OTTO script, you will need to whitelist the OTTO domain in your store's CSP configuration. Consult your developer to add the required domain to your store's CSP allowlist.
📋 When to Escalate
If you have worked through all of the steps above and OTTO still does not detect the pixel, please have the following ready before reaching out to support:
- Your project or website name in Search Atlas
- A description of where and how you added the pixel code
- Confirmation of which caches have been cleared
- Any error messages visible in your browser console (F12 → Console)
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.