Search Atlas Help Center

🔌 Fix WordPress OTTO Connection and Authentication Issues

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

Camilo Aponte

Last updated on Sep 30, 2026

🔍 Overview

If your WordPress site is not connecting or authenticating with OTTO SEO, this guide walks you through the correct installation process, common causes of failure, and how to verify a successful connection.

📋 Before You Begin

Make sure you have the following ready before starting:

  • An active Search Atlas account with OTTO SEO access
  • Administrator access to your WordPress site
  • The Search Atlas OTTO SEO plugin installed on your WordPress site

🛠️ Step 1 — Install the OTTO SEO WordPress Plugin

  1. Log in to your WordPress admin dashboard.
  2. Go to Plugins → Add New and search for Search Atlas OTTO SEO.
  3. Click Install Now, then click Activate.

Important: The plugin does nothing on its own. It must be connected to an active Search Atlas account to function. Activating the plugin without completing the connection steps below will result in no data being processed.

🔗 Step 2 — Connect Your WordPress Site in Search Atlas

  1. In Search Atlas, go to Left sidebar → OTTO SEO → Installation Guide for the full, up-to-date connection walkthrough.
  2. If you are adding a new site, go to Left sidebar → OTTO SEO → All Sites and click Create.
  3. When prompted to add a connector, select WordPress as your CMS type.
  4. Follow the on-screen prompts to generate your unique connection credentials.

🔑 Step 3 — Authenticate the Plugin on Your WordPress Site

  1. In your WordPress admin dashboard, navigate to the Search Atlas OTTO SEO plugin settings page.
  2. Enter the connection credentials provided in the Search Atlas platform (from Step 2).
  3. Click Save or Connect to submit your credentials.
  4. Return to Search Atlas and go to Left sidebar → OTTO SEO → Overview. If the connection was successful, your site status will update and you can click Scan to begin processing.

⚠️ Common Reasons the Connection Fails

  • Incorrect credentials: Copy and paste the connection credentials directly from the Search Atlas platform — do not type them manually to avoid typos.
  • Plugin not activated: The plugin must be both installed and activated in WordPress before authentication can succeed.
  • Caching plugin interference: If your site uses a caching plugin (e.g., WP Rocket, W3 Total Cache), clear your cache after saving the plugin credentials and try again.
  • WordPress REST API blocked: Some security plugins or server configurations block the WordPress REST API. Check that the REST API is accessible, as OTTO uses it to communicate with your site.
  • User role permissions: Ensure the WordPress account used during setup has Administrator privileges.
  • Outdated plugin version: Go to Plugins → Installed Plugins in WordPress and confirm the OTTO SEO plugin is up to date.

✅ How to Verify a Successful Connection

  • Go to Left sidebar → OTTO SEO → Overview in Search Atlas.
  • Your site should appear with an active status and options to Scan or manage your OTTO deployment.
  • If the site still shows as disconnected after completing all steps, wait 2–3 minutes and refresh the page, as the pull-based connection check may take a moment to update.

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