This guide outlines the validated implementation for installing the OTTO Pixel on websites built with Webflow, ensuring that OTTO’s diagnostic system correctly detects the Pixel and activates automated SEO optimization.
⚠️ This method has been thoroughly tested and is the most reliable installation workflow for Webflow sites.
📄 Step 1: +Create a new project.
📄 Step 1: +Create a new project.
Start inside your Search Atlas dashboard.
Left Sidebar → AI SEO → All Sites → + Create (top-right)
Follow the Setup Steps.
🌐 Step 2: Select or Add Your Website
🌐 Step 2: Select or Add Your Website
Enter your full URL (e.g., https://yourdomain.com).
• Wait for the green verification check mark confirming the domain.
• Then click "Continue".
📝 Step 3: Set up Fields (Optional).
📝 Step 3: Set up Fields (Optional).
You will see fields for Business Information, Address, and Social Profiles.
• These fields are optional for Pixel installation.
• You may complete them now or later.
Click "Continue" to proceed.
📎 Step 4: Copy Your OTTO Pixel Script.
📎 Step 4: Copy Your OTTO Pixel Script.
Inside the Installation Guide:
• Select Webflow from the CMS list.
Click the Video Guide Card, then scroll to Pixel Code and copy it.
Click "Step by step" for detailed Webflow instructions (See the next step).
Click "Continue" in the bottom right corner.
Stop here — now switch to your Webflow dashboard to insert the script before returning to Search Atlas.
🛠️ Step 4: Install the OTTO Pixel Script in Webflow.
🛠️ Step 4: Install the OTTO Pixel Script in Webflow.
Now that you have your OTTO Pixel script copied, you can just switch to your Webflow dashboard to install it globally across your entire website.
Step-by-step:
1. Log in to your Webflow Dashboard.
Open Webflow and make sure you’re in the project you want to connect to OTTO.
2. In the left sidebar, click “All Sites.”
This returns you to the main list of your Webflow projects.
3. Hover over your site and click the ⚙️ “Settings” icon.
This opens the Site Settings panel for your Webflow project.
4. In the top navigation of Site Settings, select “Custom Code.”
This is where Webflow stores all global header and footer scripts.
5. Scroll to the “Head code” section.
You will see a large code box labeled:
“Add code at the end of the <head> tag.”
This is the correct location for installing the OTTO Pixel.
6. Paste your OTTO Pixel <script> into the Head code box.
Paste it exactly as provided in Search Atlas, with no modifications.
7. Click the blue “Save” button on the right.
This saves your global header script to your project.
8. Publish your website.
At the top right of the page:
Click Publish → Publish to Selected Domains.
This pushes the Pixel to the live version of your website, which OTTO will scan.
⚠️ Important:
If you do not click Publish, the Pixel will not appear in your live HTML, and OTTO will return “Not Installed.”
🚀 Step 5: Activate in Search Atlas.
🚀 Step 5: Activate in Search Atlas.
Once OTTO completes the initial setup for your project, your website appears inside the OTTO SEO (📊) Automation dashboard. You need to click on your project.
Then you'll see:
• Your domain name at the top (e.g., https://yourdomain.com).
• Below it, your SEO performance metrics, including:
– Healthy Pages (pages scanned so far)
– OTTO Grader (overall site health score)
– Content, Authority, Technicals, UX Signals (the four SEO pillar indicators)
On the right side of the site row, you’ll see:
• A red status label such as “Not Installed” or “OTTO Not Found.”
→ This means the OTTO Pixel has not been verified yet.
• A Scan button
→ Used to run OTTO’s Installation Diagnostics.
• A yellow/orange Disengaged toggle
→ Indicates OTTO is inactive until Pixel verification succeeds.
Next Steps
1️⃣ Click Engage OTTO.
This enables the site for testing and prepares the system to check your Pixel connection.
2️⃣ Click Scan.
This opens the Installation Diagnostics modal.
Your domain (e.g., https://yourdomain.com) will appear automatically in the field.
3️⃣ Verify the domain, then click Run Diagnostics.
OTTO will begin scanning your site for the installed Pixel.
During this stage, you’ll see the message:
“Running Diagnostics…
We’re checking the selected page for any OTTO implementation issues.
This might take a few seconds — hang tight!
A detailed report will be ready shortly.”
This confirms that OTTO is checking your site for the Pixel across your environment. The scan may take a couple of minutes — this is normal.
⏳ If the status remains red after the scan:
Wait 3–5 minutes to allow the Pixel to propagate across your domain fully. Then refresh the OTTO SEO dashboard — the status should update once the Pixel is detected.
That’s it! The OTTO Pixel is now live on your GHL site, powering automated insights and performance boosts for your SEO strategy. Make sure to revisit the diagnostics panel anytime to ensure your tracking is running smoothly.
🔎 Understanding Your OTTO Installation Diagnostics Results
After you click Scan → Run Diagnostics, OTTO inspects your website to verify Pixel installation, detect duplicates, confirm UUID validity, and validate deployed SEO fixes.
Below is what each possible status means and what you should do next:
❌ 1. “OTTO not detected.”
❌ 1. “OTTO not detected.”
What does it mean:
OTTO couldn’t find your Pixel script in the live HTML for the scanned URL.
Why does it happen:
Pixel not installed
Pixel added to the wrong theme/template
Installed on staging but not production
Installed on a different domain variant (www vs non-www / http vs https)
What to do:
Reinstall the Pixel using the correct installation guide, then wait 3–5 minutes for the status to update after saving changes.
❌ 2. “Your script is using an incorrect UUID.”
❌ 2. “Your script is using an incorrect UUID.”
What does it mean:
A Pixel exists, but the UUID doesn’t match the one assigned to your site.
Why does it happen:
Pixel copied from another project
Duplicate site setup
Wrong script was pasted into the template
Old Pixel copied before regenerating a new one
What to do:
Replace the script with the correct Pixel UUID from your Installation Guide.
Then wait up to 3 minutes for OTTO to re-check the installation.
⚠️ 3. “Duplicate Installation Detected.”
⚠️ 3. “Duplicate Installation Detected.”
What does it mean:
OTTO found more than one Pixel on your site.
Possible duplicates:
JavaScript Integration duplicated
WordPress Plugin + JavaScript script at the same time
Multiple manual Pixels installed across templates
Pixel is installed in both global and page-level injectors
What to do:
Remove the extra instances and leave only one valid Pixel.
Once fixed, wait 3 minutes for the system to update.
🟡 4. “OTTO is disengaged.”
🟡 4. “OTTO is disengaged.”
What does it mean:
Your Pixel may be installed, but OTTO is not turned on for this site.
What to do:
Return to the OTTO dashboard → click Engage OTTO → re-run Scan → Run Diagnostics.
🟢 5. “Deployed Fixes Verification — OK”.
🟢 5. “Deployed Fixes Verification — OK”.
What does it mean:
OTTO confirms that on-page fixes (meta tags, headings, titles, etc.) have been properly deployed and rendered in the live HTML.
This means everything is functioning normally.
⚠️ 6. “Some deployments were not identified in our scan.”
⚠️ 6. “Some deployments were not identified in our scan.”
What does it mean:
At least one of the fixes OTTO attempted to deploy did not appear in your rendered HTML during the verification pass.
Why does it happen:
Cache not cleared
CDN is still serving an old version
Fix deployed but not published
Plugin conflict (WordPress only)
JavaScript rendering delay
What to do:
Click View Issue to see which page or tag failed → then re-run Scan after clearing cache.
🟣 7. The Purple Banner (First-Time Installations).
🟣 7. The Purple Banner (First-Time Installations).
If this is your first Pixel installation, you may also see:
“Site processing is still in progress.”
“Waiting for data…”
“No crawl data available yet.”
“Pixel detected — awaiting first scan results.”
This is normal.
OTTO’s first crawl can take up to 24 hours, depending on site size and CMS.
If more than 24 hours pass → go to
Scan → Run Diagnostics → Re-run Crawl.
🧭 Summary of What Your Results Mean.
🧭 Summary of What Your Results Mean.
Message | Meaning | Action |
❌ OTTO not detected | Pixel missing | Install + Publish + rescan |
❌ Incorrect UUID | Wrong script | Replace Pixel + Publish |
⚠️ Duplicate Pixel | More than one Pixel | Remove duplicates |
🟡 OTTO disengaged | Pixel found but inactive | Engage OTTO |
🟢 Fixes Verified | Working correctly | No action |
⚠️ Fixes Missing | Fixes not in HTML | Clear cache + rescan |
🟣 Processing banner | First crawl running | Wait or Re-run Crawl |
Your Webflow site is now fully linked to OTTO, enabling automated SEO crawling, issue detection, and AI-powered optimization workflows. Whenever you update your Webflow theme or code injection settings, run a Diagnostic Scan to confirm the Pixel is still active.