Search Atlas Help Center

🛠️ Fix OTTO Plugin Errors and Missing Projects

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

Camilo Aponte

Last updated on Sep 30, 2026

🔍 Overview

After installing the OTTO plugin on your website, you may encounter a few common issues: an 'otto not found' error, projects that seem to disappear from your Search Atlas dashboard, or no active projects appearing on the homepage. This article walks you through the most likely causes and how to resolve each one quickly.

⚙️ Step 1: Verify the OTTO Plugin Is Installed Correctly

The 'otto not found' error almost always means the plugin was not fully activated or is not communicating with Search Atlas. Follow these steps to confirm your installation:

  1. Log in to your WordPress admin panel and go to Plugins → Installed Plugins.
  2. Confirm the OTTO SEO plugin is listed and its status shows Active. If it shows Inactive, click Activate.
  3. If the plugin is not listed at all, reinstall it. Go to Plugins → Add New → Upload Plugin, upload the plugin .zip provided by Search Atlas, install it, and then activate it.
  4. After activation, return to your Search Atlas dashboard and navigate to OTTO SEO in the left sidebar, then open SEO Automation (URL: /seo-automation-v3). Check whether your site now appears as a connected project.

If the plugin is active but the error persists, deactivate it, wait 30 seconds, then reactivate it to force a fresh connection handshake.

🔑 Step 2: Reconnect Your Site With the Correct API Key

A broken or missing API key is a common reason the plugin cannot locate your OTTO project. To check this:

  1. In your WordPress admin panel, open Search Atlas → Settings.
  2. Paste your Search Atlas API Key into the designated field.
  3. Paste your OTTO Pixel UUID.
  4. Click Save and refresh the page. The connection status should update to Connected.

Make sure there are no extra spaces before or after the API key when pasting it — this is a frequent cause of authentication failures.

📊 Step 3: Restore Missing Projects in the Dashboard

If your projects have disappeared from the Search Atlas web version, this is typically caused by one of the following:

  • Workspace mismatch: Confirm you are logged in to the correct workspace. Click your account name in the top-right corner and verify the active workspace matches the one where your projects were created.
  • Browser cache: Clear your browser cache and cookies, then hard-refresh the page (Ctrl + Shift + R on Windows or Cmd + Shift + R on Mac).
  • Session timeout: Log out of Search Atlas completely, log back in, and navigate to OTTO SEO → All Sites (SEO Automation) to see if your projects reload.

Projects are tied to your workspace and account — they are never permanently deleted by a plugin installation. If they are not visible after the steps above, the issue is almost certainly a workspace or session problem.

🚀 Step 4: Confirm Active Projects Appear on the Homepage

The Search Atlas homepage displays a summary of your active projects. If this section appears empty after setup:

  1. Navigate to OTTO SEO in the left sidebar, then open SEO Automation (URL: /seo-automation-v3) and confirm at least one project exists and has a status of Active.
  2. If a project exists but shows a Pending or Disconnected status, complete the reconnection steps in Step 2 above.
  3. Once a project is confirmed active, return to the homepage. Active projects should populate within a few seconds. If the page still appears empty, perform a hard-refresh.

🌐 Step 5: Trigger or Re-run a Site Audit Crawl

After successfully connecting the plugin, you may need to manually trigger your first site audit crawl so Search Atlas can begin collecting data:

  1. Go to OTTO SEO in the left sidebar, then open Site Audit → Overview (Website Overview).
  2. Click Recrawl Site if a previous crawl appears stalled or incomplete.
  3. Crawl times vary depending on site size. Small sites typically complete within a few minutes; larger sites may take longer.

Do not close the tab while the crawl is in progress. Once complete, your audit data will be available inside the project dashboard.

💡 Quick Troubleshooting Checklist

  • Plugin active? Confirm in WordPress → Plugins → Installed Plugins.
  • API key correct? Re-paste at Search Atlas → Settings in WordPress — no extra spaces.
  • Right workspace? Check account switcher in top-right corner.
  • Browser cache cleared? Hard-refresh after clearing.
  • Crawl started? Manually trigger from OTTO SEO → Site Audit → Overview (Website Overview) using the Recrawl Site button.

🙋 Still Need Help?

If you have followed all the steps above and are still experiencing issues, 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.