π What this connection does
Connecting Shopify to OTTO lets Search Atlas read your storefront through a small pixel that includes your site UUID. The full snippet must be saved in the published theme so it loads on your public pages.
π Before you start
- Use a Shopify account that can edit theme code.
- In Search Atlas, open your site in OTTO and copy the full installation snippet. Pasting only the UUID is not enough.
- Edit the theme shoppers actually see, usually marked as the current or published theme.
- Note the exact domain connected in Search Atlas, including https and www, so it matches the live store.
π οΈ Add the pixel in theme.liquid
- In Shopify admin, go to Online Store, then Themes.
- On the published theme, open the actions menu and choose Edit code.
- Under Layout, open theme.liquid.
- Find the closing head tag near the top of the file.
- Paste the full OTTO snippet on its own lines just before that closing tag.
- Select Save and confirm Shopify shows that the file saved.
Do not place the snippet only in a product template, footer, or Custom Liquid section. Those areas do not load on every page and may not appear in the page head.
π Check the live page source
- Open your public homepage in a new browser tab. Do not check the Shopify admin or the theme editor canvas.
- If the store is password protected, enter the password, then reload the homepage.
- Right-click the page and choose View page source. Raw source is more reliable than the Elements panel.
- Press Ctrl+F or Cmd+F and search for your UUID exactly as shown in Search Atlas.
- Also search for otto. You should see the snippet you pasted.
- If the page looks outdated, hard-refresh it or open it in a private window and check again.
β οΈ If the UUID is still missing
- Wrong theme: The snippet may be in an unpublished or duplicate theme. Repeat the steps on the current theme.
- UUID text only: A bare UUID in the head does not install OTTO. Replace it with the full snippet from Search Atlas.
- Snippet outside the head: Move it so it sits before the closing head tag, not in the body or a section file.
- Code was overwritten: A theme update, app, or restored backup can remove custom code. Open theme.liquid and confirm the snippet is still there.
- Wrong URL: View source on the same domain connected in Search Atlas, including www versus non-www.
- Cached page: Clear the browser cache or use a private window, then view source again.
β Finish the site connection
- Return to the site in Search Atlas OTTO after the UUID is visible in the live source.
- Run the connection or verification step shown for that site.
- Allow a short time for the pixel to be detected, then refresh the OTTO status.
- If it stays disconnected, confirm the domain spelling and that the snippet is on the homepage and at least one inner page.