Overview

When OTTO fails to connect to a project, you may see a missing or blank service ID, OTTO Score errors across all sites, and OTTO SEO Strategy features that are unavailable. These symptoms commonly trace back to a pixel installation problem, a script conflict, or a caching issue. Follow the steps below in order to diagnose and resolve the connection failure.

Step 1: Confirm Your Service ID Exists

A service ID is generated when OTTO is successfully linked to a project. If no service ID appears, the connection did not complete.

1. Navigate to the OTTO SEO section of the platform and select the affected project.
2. Look for your service ID in your OTTO or OTTO SEO settings area. If the field is blank or shows an error, do not proceed with pixel installation until the connection has been refreshed.
3. Try disconnecting and reconnecting OTTO to the project, then check whether a service ID is generated.
4. Copy the service ID once it appears and keep it ready for the steps below.

Step 2: Verify Pixel Installation on Your Site

The OTTO pixel must be present on every page of your site for the service ID to register correctly. Choose the installation method that matches your setup.

WordPress Plugin Method

1. Log in to your WordPress admin dashboard.
2. Install and activate the OTTO pixel plugin associated with your Search Atlas account.
3. Open the plugin settings and paste your service ID into the designated field.
4. Save changes and confirm the pixel snippet appears in your site's <head> section by viewing the page source and searching for your service ID.

Manual Script / Custom Code Method

1. From your OTTO settings, copy the full pixel script snippet.
2. Paste the snippet inside the <head> tag of your site's HTML template or theme header file so it loads on every page.
3. If you use a page builder, place the script in the builder's global custom code or header scripts section rather than on individual pages.
4. Save and publish your changes, then verify the snippet is present in the page source.

Google Tag Manager Method

1. Open your GTM container and create a new custom HTML tag.
2. Paste the OTTO pixel script into the tag body.
3. Set the trigger to fire on all pages.
4. Submit and publish the container version.
5. Use GTM's preview/debug mode to confirm the tag fires on page load before moving to the next step.

Step 3: Clear Cache and Test

Caching can prevent an updated pixel from being detected. After installing or updating the pixel:

1. Clear your site's server-side cache, any caching plugin cache (such as WP Rocket, W3 Total Cache, or LiteSpeed Cache), and your CDN cache if applicable.
2. Open your site in a private/incognito browser window to avoid brow

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.