Complete Guide to Setting Up OMNIS on Shopify

Copy your embed snippet from OMNIS

In the OMNIS dashboard, go to the Deploy page. Click Copy embed code — this copies a script tag that already has your unique token and the correct URL filled in. You do not need to edit anything in it.

Add it to your Shopify theme

1. 1In your Shopify admin go to Online Store → Themes and click Edit theme.
2. 2In the theme editor, click on the Header and add a Custom code section.
3. 3Paste your embed snippet into the code field on the right.
4. 4Click Save.

Add your pages

In the OMNIS dashboard open the Navigator page. Click Add entry, choose Page as the type, and fill in:

• Name — what the page is called (e.g. “Products”, “About”)
• URL — the path on your store (e.g. /collections/all or /pages/about)
• Description — one sentence about what's on this page. The AI reads this to decide when to navigate here.

Find your section IDs

Sections are areas within a page the agent can scroll to — for example a testimonials block, a featured collection, or a contact form. Each section needs an HTML id attribute on its outermost element.

The easiest way to find section IDs is to right-click any part of your storefront, click Inspect, and look for the id="..."on the section's wrapper div.

<!-- Right-click any section on your storefront → Inspect -->
<!-- Look for the id="..." attribute on the outermost div of that section -->

<div id="hero" class="shopify-section ...">        ← section ID is "hero"
<div id="featured-collection" class="shopify-section ...">  ← "featured-collection"
<div id="testimonials" class="shopify-section ...">  ← "testimonials"

Shopify themes render sections with either a dynamic ID from {{ section.id }} (a hash like template--16__hero) or a fixed string set by the theme developer. Both work fine — just copy whatever the id value is.

<!-- In your section's Liquid file, the container usually looks like this -->
<div id="{{ section.id }}" class="my-section">
  ...
</div>

<!-- But many themes use a fixed string ID instead -->
<div id="featured-products" class="my-section">
  ...
</div>

Add your sections in the dashboard

Back in the Navigator page, click Add entry and choose Section. For each section enter:

• Name — what this section contains (e.g. “Testimonials”)
• Section ID — the exact id value from the HTML (e.g. testimonials)
• Parent page — which page this section lives on
• Description — one sentence about what's in this section

Find your variant IDs

This is the most important thing to get right. In Shopify, every product has one or more variants (different sizes, colours, etc.). The Shopify cart API requires the variant ID — not the product ID — to add an item to cart. These are two different numbers.

There are three ways to find the variant ID:

<!-- Option 1: from the Shopify admin URL -->
<!-- Navigate to: Products → click product → click a variant -->
<!-- The URL looks like: -->
admin.shopify.com/store/YOUR-STORE/products/8291234567/variants/44012345678901
                                                                 ↑
                                                           This is the variant ID

<!-- Option 2: from the storefront -->
<!-- Add ?variant=XXXXX to a product URL and look at the variant param -->
your-store.myshopify.com/products/blue-sneaker?variant=44012345678901

Add your products in the dashboard

In the Navigator page, switch to the Products tab, click Add entry and choose Product. For each product (or variant) enter:

• Name — what the agent will call this product in conversation
• Product ID — the Shopify variant ID (see step above)
• Description — one sentence about this product (price, key features, etc.)