Search Atlas Help Center

🛠️ Fix OTTO Plugin UUID Configuration Errors in WordPress

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

Camilo Aponte

Last updated on Sep 30, 2026

🔍 What Is a UUID Mismatch Error?

When you connect the OTTO SEO plugin to your WordPress site, it relies on a Universally Unique Identifier (UUID) to link your site to the correct Search Atlas project. If this UUID does not match the one associated with your project — for example, your Jade project — the OTTO pixels will fail to fire correctly and display a configuration error.

This mismatch is one of the most common reasons OTTO pixels show errors inside WordPress. The good news is that it is straightforward to diagnose and fix.

⚠️ Common Causes of a UUID Mismatch

  • Copy-paste errors: The UUID was entered incorrectly when setting up the plugin, such as missing characters or including extra spaces.
  • Wrong project selected: The UUID copied belongs to a different Search Atlas project, not the one intended for this site.
  • Plugin reinstallation: The plugin was reinstalled or reset without re-entering the correct UUID.
  • Multiple sites or projects: Managing several sites can lead to UUIDs being swapped between projects accidentally.
  • Outdated plugin version: An older version of the OTTO plugin may not read or store the UUID correctly.

🔎 How to Find Your Correct UUID in Search Atlas

  1. Log in to your Search Atlas account.
  2. In the left sidebar, click OTTO SEO, then open SEO Automation (URL: /seo-automation-v3).
  3. Select the project you want to connect — for example, your Jade project.
  4. Locate the OTTO Setup or Connect Site section within that project.
  5. Copy the UUID displayed. Make sure you copy the full string with no extra spaces before or after it.

🛠️ How to Fix the UUID in Your WordPress Plugin

  1. Log in to your WordPress admin dashboard.
  2. In the left menu, navigate to the Search Atlas plugin → Settings → General tab.
  3. Find the field labelled OTTO Pixel UUID.
  4. Clear the existing value completely.
  5. Paste the correct UUID you copied from Search Atlas.
  6. Click Save or Update Settings.
  7. Return to Search Atlas and refresh the OTTO SEO page to confirm the OTTO pixels are now active and showing no errors.

✅ How to Verify the Connection Is Working

  • In Search Atlas, go to OTTO SEO and open your project. The OTTO status indicator should show as Connected or Active.
  • In WordPress, check the OTTO plugin dashboard for any remaining error messages. If the UUID is correct, errors should clear within a few minutes.
  • Check that OTTO pixels are being detected on your site pages as expected.

💡 Best Practices to Prevent Future UUID Errors

  • Always copy the UUID directly from Search Atlas rather than typing it manually.
  • Keep a secure note of each project's UUID alongside its corresponding domain so you can reference it quickly.
  • After reinstalling or updating the OTTO plugin, verify the UUID is still correctly saved in the settings.
  • If you manage multiple WordPress sites, double-check that each site has its own unique project UUID and they have not been swapped.
  • Keep the OTTO plugin updated to the latest version to ensure compatibility with Search Atlas.

🆘 Still Seeing Errors?

If you have followed all the steps above and the UUID mismatch error persists, there may be a deeper configuration issue with your project or plugin installation. 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.