## **🔍 Overview**

The OTTO Pixel WordPress plugin links your website to Search Atlas so OTTO SEO can read your site data and apply optimizations. When the plugin shows **Synced** inside WordPress but Search Atlas still cannot detect it, a configuration or connectivity issue is preventing the two systems from communicating. This guide walks you through every fix, step by step.

## **✅ Before You Begin**

Confirm the following before diving into deeper troubleshooting:

- You are logged in to Search Atlas and viewing the correct project/domain.
- The OTTO Pixel plugin is **active** (not just installed) in your WordPress dashboard under **Plugins → Installed Plugins**.
- You installed the plugin using the unique pixel key generated inside Search Atlas — not a generic copy.

## **🛠️ Step 1 — Verify Your Pixel Key**

Each domain in Search Atlas has its own unique pixel key. Using the wrong key is the most common cause of sync failures.

1. In Search Atlas, go to **OTTO SEO → SEO Automation** (left sidebar, URL: `/seo-automation-v3`).
2. Select your website and open the **OTTO SEO** panel.
3. Locate your **Pixel Key** and copy it exactly — including any hyphens or uppercase letters.
4. In WordPress, go to **Search Atlas (WP menu) → Settings** and paste the key into the **OTTO Pixel UUID** field.
5. Click **Save Changes**, then return to Search Atlas and wait up to 60 seconds for detection.

## **🔄 Step 2 — Deactivate, Reinstall, and Reactivate**

A corrupted plugin installation can cause silent sync failures even when WordPress reports the plugin as active.

1. In WordPress, go to **Plugins → Installed Plugins**.
2. Click **Deactivate** next to OTTO Pixel, then click **Delete**.
3. Return to Search Atlas and copy your pixel key again (see Step 1).
4. Reinstall the OTTO Pixel plugin by uploading the latest .zip version provided in Search Atlas via **Plugins → Add New → Upload Plugin**.
5. Enter your pixel key, save, and activate the plugin.
6. Check Search Atlas for detection — allow up to 2 minutes.

## **🌐 Step 3 — Check for Firewall or Security Plugin Conflicts**

Security plugins and server-level firewalls sometimes block the outbound requests the OTTO Pixel plugin needs to reach Search Atlas servers.

- **Wordfence, Sucuri, iThemes Security:** Temporarily disable the firewall rules or whitelist Search Atlas domains (`searchatlas.com` and its subdomains).
- **Cloudflare:** Set your domain's security level to **Essentially Off** temporarily and retest. If detection succeeds, add a firewall rule to allow traffic to/from Search Atlas.
- **Hosting-level firewalls (e.g., SiteGround, WP Engine):** Contact your host or check your control panel to whitelist outbound requests to Search Atlas.

After whitelisting, reactivate your security settings and recheck Search Atlas for detection.

## **⚙️ Step 4 — Confirm PHP and WordPress Requirements**

The OTTO Pixel plugin requires a minimum environment to run correctly.

- **PHP version:** 7.4 or higher (PHP 8.x recommended).
- **WordPress version:** 5.8 or higher.
- **HTTPS:** Your site must be served over HTTPS. An SSL certificate must be active and valid.

You can check your PHP version at **WordPress Dashboard → Tools → Site Health → Info → Server**. If your environment is below these minimums, contact your hosting provider to upgrade.

## **🧹 Step 5 — Clear All Caches**

Cached responses can prevent the plugin's verification handshake from completing.

1. Clear your WordPress caching plugin cache (e.g., WP Rocket, W3 Total Cache, LiteSpeed Cache) — look for a **Clear Cache** or **Flush Cache** button in the plugin settings or admin toolbar.
2. Clear your Cloudflare or CDN cache if applicable.
3. Clear your browser cache and try reloading Search Atlas in a private/incognito window.
4. Return to Search Atlas and check for detection once more.

## **📋 Step 6 — Test in a Staging or Default Theme Environment**

Theme functions or other plugins occasionally interfere with pixel output. To isolate the issue:

- Temporarily switch to a default WordPress theme (e.g., **Twenty Twenty-Four**) and recheck detection in Search Atlas.
- Disable all plugins except OTTO Pixel, then recheck. Re-enable plugins one at a time to identify any conflict.

If detection succeeds after switching themes or disabling plugins, you have identified the conflicting item. Reach out via chat (see below) and share the conflicting plugin or theme name so our team can advise further.

## **💡 Still Not Working?**

If you have completed all steps above and Search Atlas still does not detect the OTTO Pixel, there may be a server-level or account-level issue that requires manual investigation. 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.

When you open the chat, please share: your domain URL, a screenshot of your OTTO Pixel plugin settings page in WordPress, and the name of any security plugins or CDN services active on your site. This helps our team resolve your issue as quickly as possible.