Search Atlas Help Center

🔌 Install the OTTO Pixel on WordPress Sites

Open in
View as Markdown Open in ChatGPT Open in Claude
Camilo Aponte

Camilo Aponte

Last updated on Sep 30, 2026

🧩 What Is the OTTO Pixel?

The OTTO pixel is a small tracking script that connects your WordPress site to Search Atlas. It allows OTTO to read your site's on-page data and apply SEO automations directly. Until the pixel is confirmed active, OTTO's automation features will remain limited.

📋 Before You Begin

  • You have admin access to your WordPress site.
  • You are logged in to Search Atlas and have navigated to OTTO SEO → SEO Automation in the left sidebar (URL: /seo-automation-v3).
  • You have your Search Atlas API key and OTTO Pixel UUID ready to copy from the dashboard.

🛠️ How to Install the OTTO Pixel on WordPress

  1. Install the Search Atlas (MetaSync) plugin on your WordPress site.
  2. In WordPress, open Search Atlas → Settings.
  3. Paste your Search Atlas API key into the API key field.
  4. Paste your OTTO Pixel UUID.
  5. Save your changes. The plugin will handle the pixel installation automatically. The raw JavaScript code snippet is only needed for non-WordPress platforms or alternative installs such as Google Tag Manager.

⏳ Why the Status Still Shows "Not Installed Correctly"

This is expected behaviour — not an error. After you install the pixel, Search Atlas needs time to detect and verify the script across your site. For new projects, automatic checks run every 15 minutes, so detection typically happens within about 15 minutes from the moment the pixel goes live. During this window, the dashboard will continue to display the "OTTO Pixel is not installed correctly" message even when installation was completed perfectly.

Please do not reinstall the pixel or make further changes during this period. Multiple installations can cause duplicate script conflicts that will require you to start over.

✅ How to Confirm the Pixel Is Live Before the Status Updates

You can verify the pixel is on your site right now without waiting for the dashboard to update:

  1. Open your WordPress site in a browser.
  2. Right-click anywhere on the page and select View Page Source.
  3. Press Ctrl + F (Windows) or Cmd + F (Mac) and search for otto or the first few characters of your pixel code.
  4. If the script appears in the source, your installation is correct. The dashboard status will catch up within about 15 minutes on a new project.

🔄 What to Do After 15 Minutes

  • Refresh the OTTO SEO → SEO Automation page in Search Atlas.
  • If the status has changed to active or connected, no further action is needed.
  • If the status still shows an error after about 15 minutes and the pixel code is not visible in your page source, move on to the troubleshooting steps below.

🔧 Troubleshooting a Genuinely Failed Installation

If the pixel code is not found in your page source after about 15 minutes, work through these checks:

  • Caching: WordPress caching plugins (e.g., WP Rocket, W3 Total Cache) may serve old pages. Clear your site cache and check the page source again.
  • Theme updates: If your theme was recently updated, the header.php edit may have been overwritten. Re-paste the pixel or switch to a plugin-based installation method.
  • Plugin conflicts: Temporarily deactivate security or optimisation plugins that may strip unrecognised scripts from the <head> tag, then check the page source.
  • Correct placement: Confirm the pixel is placed before </head> and not inside the <body> or footer section.
  • Multiple pixel copies: Search your page source for more than one instance of the script. Remove duplicates and leave only one copy.

💬 Still Need 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.