🔍 What Is a UUID Mismatch?
When you activate OTTO SEO on your website, Search Atlas generates a UUID (Universally Unique Identifier) — a unique code that links your site to your OTTO SEO workspace. A UUID mismatch occurs when the UUID that OTTO detects on your site does not match the one stored in your Search Atlas account.
This issue most commonly appears when your site is proxied through Cloudflare DNS. Cloudflare's caching and proxy settings can interfere with how the UUID is served and verified, causing OTTO SEO to fail validation even if you followed every setup step correctly.
⚙️ Why Cloudflare Can Cause This Problem
Cloudflare sits between your visitors (and Search Atlas) and your origin server. When OTTO SEO attempts to verify your UUID, it sends a request to your domain. If Cloudflare is caching an old version of the page or blocking certain requests, the UUID it returns may be outdated, missing, or from a different deployment entirely. Common contributing factors include:
- Aggressive page caching — Cloudflare serves a cached page that does not contain the latest UUID snippet.
- Performance features that modify JavaScript — Certain Cloudflare optimizations can defer or alter scripts, which may prevent the UUID from loading correctly at verification time.
- Security or bot-filtering rules — Firewall or bot-protection settings may block the Search Atlas verification crawler before it can read the UUID.
- Proxied DNS records — Proxy mode routes traffic through Cloudflare, which can alter the response seen by the OTTO verifier.
🚀 What to Do When You Experience a UUID Mismatch
Because the exact configuration that causes a UUID mismatch can vary depending on your Cloudflare setup, the most reliable path to resolution is to contact our support team directly. When you reach out, please have the following ready so our team can investigate efficiently:
- Your Search Atlas project/site name and the domain experiencing the mismatch
- A description of your Cloudflare DNS configuration (e.g., whether the DNS record is proxied or DNS-only)
- Any Cloudflare features you have enabled that affect JavaScript delivery, caching, or security/bot filtering
- The exact error message or status shown in your Search Atlas account when validation fails
- A timestamp of when the issue first occurred or was last observed
Having this information ready will allow our team to identify the specific Cloudflare setting interfering with UUID validation and guide you through the correct fix for your 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.