πŸ”— Connect Shopify to the OTTO Pixel

Camilo Aponte

Camilo Aponte

Last updated on Nov 8, 2026

πŸ”— 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

  1. In Shopify admin, go to Online Store, then Themes.
  2. On the published theme, open the actions menu and choose Edit code.
  3. Under Layout, open theme.liquid.
  4. Find the closing head tag near the top of the file.
  5. Paste the full OTTO snippet on its own lines just before that closing tag.
  6. 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

  1. Open your public homepage in a new browser tab. Do not check the Shopify admin or the theme editor canvas.
  2. If the store is password protected, enter the password, then reload the homepage.
  3. Right-click the page and choose View page source. Raw source is more reliable than the Elements panel.
  4. Press Ctrl+F or Cmd+F and search for your UUID exactly as shown in Search Atlas.
  5. Also search for otto. You should see the snippet you pasted.
  6. 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

  1. Return to the site in Search Atlas OTTO after the UUID is visible in the live source.
  2. Run the connection or verification step shown for that site.
  3. Allow a short time for the pixel to be detected, then refresh the OTTO status.
  4. If it stays disconnected, confirm the domain spelling and that the snippet is on the homepage and at least one inner page.

**πŸ’¬ Still need helpIf you need further assistance, open the chat widget in the bottom-right corner of the platform and send your message. A member of our support team will reply in the chat.

Was this article helpful?