🔍 What This Article Covers
If your Search Atlas WordPress plugin displays an 'OTTO not found' error during integration, this guide walks you through the most common causes and how to fix them quickly. Follow each section in order until the issue is resolved.
✅ Before You Begin: Prerequisites
Make sure the following conditions are met before troubleshooting:
- You have an active Search Atlas account with OTTO SEO enabled.
- You have administrator access to your WordPress site.
- Your WordPress version is 5.6 or higher.
- The Search Atlas WordPress plugin is installed and activated.
⚙️ Step 1 — Verify OTTO Is Activated in Search Atlas
The most common cause of the 'OTTO not found' error is that OTTO SEO has not been activated for your site inside the Search Atlas platform.
- Log in to your Search Atlas account.
- In the left sidebar, navigate to OTTO SEO, then open SEO Automation (URL: /seo-automation-v3).
- Confirm that your target website is listed and that OTTO has been activated for it. If you see a prompt to activate OTTO, complete that process first.
- Once activated, return to your WordPress dashboard and retry the integration.
🔑 Step 2 — Check Your API Key Connection
An incorrect or missing API key will prevent the plugin from locating your OTTO instance.
- In your WordPress admin panel, go to Search Atlas → Settings.
- Locate the API Key field and confirm it is not empty.
- In Search Atlas, go to your account settings and copy your API key.
- Paste the key into the WordPress plugin settings and click Save Changes.
- After saving, click the Test Connection button (if available) to verify the link is successful.
🌐 Step 3 — Confirm Your Site URL Matches
OTTO links to a specific domain. If the URL registered in Search Atlas does not exactly match your WordPress site URL, the integration will fail.
- In Search Atlas under OTTO SEO V3, check the domain listed for your OTTO activation.
- In WordPress, go to Settings → General and compare the WordPress Address (URL) and Site Address (URL) fields.
- Both values must match the domain in Search Atlas exactly — including whether www is present and whether the site uses https.
- If there is a mismatch, update the domain in Search Atlas or correct your WordPress URL, then retry.
🔄 Step 4 — Update or Reinstall the Plugin
An outdated or corrupted plugin file can also trigger this error.
- In WordPress, go to Plugins → Installed Plugins.
- Check whether an update is available for the Search Atlas plugin. If so, update it now.
- If no update is available and the error persists, deactivate and delete the plugin.
- Get the latest Search Atlas plugin .zip from Search Atlas (the plugin is not listed in the WordPress plugin directory).
- Reinstall and reactivate the plugin, then re-enter your API key and save.
🛡️ Step 5 — Check for Plugin or Firewall Conflicts
Security plugins, caching tools, or server firewalls can block the API requests the plugin needs to communicate with Search Atlas.
- Temporarily deactivate any security or firewall plugins (such as Wordfence or iThemes Security) and test the integration again.
- Clear your site's cache using your caching plugin or hosting control panel, then retry.
- If your hosting provider has a Web Application Firewall (WAF), ask them to whitelist outbound requests to the Search Atlas API domain.
- Re-enable your security plugins once the integration is confirmed working.
💡 Quick Reference: Common Causes and Fixes
- 'OTTO not found' error → OTTO is not activated in Search Atlas for that domain. Activate it under OTTO SEO V3 first.
- Connection fails after entering API key → API key is incorrect or copied with extra spaces. Re-copy and paste carefully.
- Integration works on staging but not production → The domain registered in Search Atlas does not match the live site URL.
- Error returns after updating WordPress → Plugin may need updating to maintain compatibility. Check for a plugin update.
🆘 Still Seeing the Error?
If you have followed all the steps above and the 'OTTO not found' error still appears, our support team can investigate your specific account configuration. 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.