Search Atlas Help Center

🔧 Install OTTO Pixel Manually on WordPress

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

Camilo Aponte

Last updated on Sep 30, 2026

🧭 Overview

The standard way to install OTTO on WordPress is the Search Atlas (MetaSync) plugin: in WordPress open Search Atlas → Settings, paste your Search Atlas API Key, and paste your OTTO Pixel UUID. If that standard installation is not detecting correctly on your WordPress site, you can install the pixel manually using a code snippets plugin or Google Tag Manager (GTM). This article walks you through both fallback methods so OTTO can start tracking your site without delay.

🔑 Before You Begin

You will need your unique OTTO pixel code. To find it:

  1. Log in to Search Atlas and navigate to OTTO SEO → All Sites (SEO Automation) in the left sidebar (URL: /seo-automation-v3).
  2. Open your OTTO session and go to the pixel installation section.
  3. Copy the full pixel script provided — keep this tab open while you work in WordPress.

🔌 Method 1: Install via WPCode (Recommended Plugin)

WPCode is the most reliable way to inject custom scripts into WordPress without editing theme files directly.

  1. Log in to your WordPress admin dashboard.
  2. In the left menu, go to Plugins → Add New and search for WPCode – Insert Headers and Footers.
  3. Click Install Now, then Activate.
  4. In the left menu, go to Code Snippets → + Add Snippet.
  5. Select Add Your Custom Code (New Snippet).
  6. Give the snippet a name, such as OTTO Pixel.
  7. Set the code type to HTML Snippet.
  8. Paste your OTTO pixel script into the code editor.
  9. Under Insertion, set the location to Site Wide Header so the pixel fires on every page.
  10. Toggle the snippet to Active and click Save Snippet.
  11. Return to Search Atlas and click Verify Pixel to confirm detection.

🧩 Method 2: Install via Code Snippets Plugin

If you prefer the Code Snippets plugin, follow these steps instead.

  1. In your WordPress admin, go to Plugins → Add New and search for Code Snippets by Code Snippets Pro.
  2. Click Install Now, then Activate.
  3. Go to Snippets → Add New in the left menu.
  4. Enter a title such as OTTO Pixel.
  5. In the code editor, paste your OTTO pixel script.
  6. Below the editor, change the Run snippet option to Run snippet everywhere.
  7. Click the dropdown arrow next to Save Changes and select Save Changes and Activate.
  8. Return to Search Atlas and click Verify Pixel to confirm detection.

📦 Method 3: Install via Google Tag Manager

Use this method if your site already uses GTM or if plugin options are not available to you.

  1. Log in to your Google Tag Manager account and open the container for your WordPress site.
  2. In the left menu, click Tags → New.
  3. Click Tag Configuration and select Custom HTML.
  4. Paste your OTTO pixel script into the HTML field.
  5. Click Triggering and select All Pages so the pixel fires site-wide.
  6. Name the tag OTTO Pixel and click Save.
  7. Click Submit in the top-right corner of GTM, add a version name, and click Publish.
  8. Return to Search Atlas and click Verify Pixel to confirm detection.

Note: If GTM is not yet installed on your WordPress site, install the GTM4WP plugin first, add your GTM container ID, and then follow the steps above.

✅ Confirming Successful Installation

After completing any of the methods above:

  • Wait 1–2 minutes, then return to your OTTO session in Search Atlas.
  • Click Verify Pixel or refresh the pixel status.
  • A green confirmation message indicates the pixel is detected and tracking correctly.
  • If the status still shows undetected, clear your site's cache (including any caching plugins such as WP Rocket or W3 Total Cache) and try verifying again.

⚠️ Common Issues and Fixes

  • Pixel not detected after installation: Clear all site caches and server-side caches, then re-verify.
  • Script stripped by WordPress: Ensure the code type in WPCode or Code Snippets is set to HTML Snippet, not PHP.
  • GTM tag not firing: Confirm the container is published and GTM is correctly embedded in your site's <head>.
  • Pixel fires on some pages only: Check that the trigger is set to All Pages and no page exclusion rules are active.

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

Additional Notes

After install, a correctly installed pixel on a new project is normally detected within about 15 minutes, as Search Atlas automatically checks every 15 minutes for projects under 2 hours old. Do not reinstall during this window; multiple installations cause duplicate script conflicts. You can verify the pixel is live before the status updates without waiting.