# **🔍 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.