🔍 What Is a UUID Mismatch?
Every OTTO SEO installation uses a unique identifier called a UUID (Universally Unique Identifier). This UUID is embedded in the OTTO pixel installed on your website. A UUID mismatch occurs when the UUID detected on your homepage does not match the UUID associated with your Search Atlas project.
When this happens, OTTO may appear as Installed in your dashboard even though it is not functioning correctly, or it may report an engaged wrong UUID — meaning it has picked up and activated a UUID that belongs to a different project or contains an invalid value.
⚠️ Common Causes of a UUID Mismatch
- Invalid username stored as UUID: In some cases, a WordPress username or other non-UUID value was incorrectly saved as the OTTO pixel identifier during setup.
- Non-canonical site ID used in the install tag: If your pixel was installed using a non-canonical version of your domain (for example, www vs. non-www), the UUID may not resolve correctly.
- Incorrect www-prefixed canonical injected: OTTO may have injected a www-prefixed canonical tag on a site that does not use www, causing the pixel to reference the wrong domain identity.
- Duplicate or conflicting pixel installations: Having multiple OTTO pixel snippets on the same page — each with different UUIDs — will cause OTTO to engage the wrong one.
🛠️ How to Troubleshoot and Fix the UUID Mismatch
- Locate your correct UUID in Search Atlas. Go to Left sidebar → OTTO SEO → SEO Automation (URL: /seo-automation-v3). Open your project and find the OTTO pixel installation section. Copy the UUID displayed there — this is your authoritative UUID.
- Check what UUID is live on your homepage. Open your homepage in a browser, right-click anywhere, and select View Page Source. Use Ctrl+F (or Cmd+F on Mac) to search for otto or uuid. Identify the UUID value currently embedded in the pixel snippet.
- Compare the two UUIDs. If the UUID in your page source does not exactly match the UUID shown in your Search Atlas project, a mismatch is confirmed.
- Remove any incorrect or duplicate pixel snippets. In your WordPress admin panel (or whichever CMS you use), locate where the OTTO pixel snippet is inserted — this is commonly in a header/footer plugin, your theme's functions.php, or a custom HTML block. Delete any snippet that contains the wrong UUID or any duplicate snippets.
- Re-install the correct OTTO pixel. Copy the full pixel snippet from your Search Atlas OTTO SEO project page and paste it into the correct location on your site. Ensure the snippet is placed within the tag of every page, including the homepage.
- Verify your canonical domain setting. Confirm whether your site uses www or non-www as its canonical domain. Make sure the pixel is installed under the matching version. If your site is non-www, do not install or reference the pixel using a www URL.
- Clear your site cache. After updating the pixel, clear any caching plugin, server-side cache, or CDN cache so the new snippet is served immediately.
- Re-check the page source. Reload your homepage, view the source again, and confirm the UUID now matches your Search Atlas project UUID exactly.
- Reconnect OTTO in Search Atlas if needed. Return to Left sidebar → OTTO SEO → SEO Automation and check your project status. If OTTO still shows as uninstalled or mismatched after the steps above, use the reconnect or re-verify option within the platform to trigger a fresh detection.
✅ How to Confirm the Fix Was Successful
After completing the steps above, your OTTO SEO project in Search Atlas should show a green Installed status with no UUID mismatch warning. The UUID visible in your homepage source code will match exactly what is displayed in your project settings. OTTO will then be able to crawl, optimise, and report on your site correctly.
💡 Tips to Prevent Future UUID Mismatches
- Always copy the OTTO pixel snippet directly from your Search Atlas project page — never type or reconstruct it manually.
- Use a single, consistent canonical domain (www or non-www) across your entire site and ensure your OTTO installation matches it.
- If you migrate your site or change your domain structure, re-install the OTTO pixel from scratch using the updated snippet from Search Atlas.
- Avoid installing third-party scripts or plugins that might overwrite or duplicate your OTTO pixel.
💬 Still Seeing a UUID Mismatch?
If you have followed all the steps above and the mismatch persists, our team is here to 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.