Installing Stockisto on Shopify

You can add the Stockisto widget to any Shopify Online Store 2.0 theme by pasting your embed snippet into a native Custom Liquid section — the same section Shopify provides for custom HTML. There is no Stockisto app to install, no account connection, and no app review.

Before you begin

You have a Stockisto account and at least one retailer imported
Your Shopify store uses an Online Store 2.0 theme (all current Shopify themes, e.g. Dawn)
You have permission to edit your theme in the Shopify admin

Step 1: Copy your embed snippet

In your Stockisto dashboard → Install → Install on Shopify, choose a placement and copy the snippet. The Store page / footer placement gives you a full store finder:

<script
    src="https://cdn.stockisto.com/widget.js"
    data-stockisto-slug="your-brand-slug"
    data-mode="finder"
    async></script>
<div id="stockisto-finder"></div>

Your snippet already contains your brand slug

The snippet in your dashboard contains your public data-stockisto-slug — don't replace or modify it. Each brand has a different slug.

Step 2: Open your theme editor

In your Shopify admin, go to Online Store → Themes
On your live theme, click Customize to open the theme editor

Step 3: Add a Custom Liquid section

Choose the page or template where the locator should appear (for a store finder, a regular page or your footer works well)
Click Add section
Select Custom Liquid
Paste your Stockisto snippet into the Custom Liquid box

Custom Liquid is built into Shopify

Custom Liquid is a native Online Store 2.0 section — you're pasting into Shopify's own section, not installing anything. It accepts raw HTML, so the Stockisto snippet works unchanged.

Step 4: Save

Click Save in the theme editor. The locator appears where you added the section.

Product-page placement (auto-fill the SKU)

To show a "where to buy" card on a product page, use the Product page placement in the dashboard. Add the Custom Liquid block to a Products template (via Add block or Add section on that template) and paste the product snippet:

<script
    src="https://cdn.stockisto.com/widget.js"
    data-stockisto-slug="your-brand-slug"
    data-mode="product-inline"
    data-sku="{{ product.selected_or_first_available_variant.sku }}"
    async></script>
<div id="stockisto-product-inline"></div>

Shopify fills in the SKU for you

Leave {{ product.selected_or_first_available_variant.sku }} exactly as written. Shopify replaces it with the current product's SKU when the page renders — so each product page shows stock for the right product. Don't edit the braces.

Allow your store domain

The widget only loads on domains you've allowed. In your Stockisto dashboard → Install → Embed script tab → Allowed origins, add your Shopify domains, one per line — both your your-store.myshopify.com domain and your custom domain if you have one:

https://your-store.myshopify.com
https://www.yourbrand.com

Verifying the installation

After saving, open a page where you added the section. You should see the Stockisto locator load. Then return to your Stockisto dashboard → Install → your Install Health will turn green within a few minutes once the widget reports in.

Open your browser console (F12) and check for [Stockisto] log messages if you want to confirm the script fired.

Troubleshooting

Problem	Likely cause	Fix
No Custom Liquid section	Vintage (non-OS-2.0) theme	Update to a current theme (e.g. Dawn), or paste the snippet into a page's HTML instead
Widget not visible	Missing container div	Paste the whole snippet — it includes the `<div>` the widget renders into
Nothing loads / blocked in console	Store domain not allowed	Add your `myshopify.com` and custom domains to Allowed origins
Product card shows the wrong stock	SKU Liquid edited	Keep `{{ product.selected_or_first_available_variant.sku }}` exactly as generated
CSP error in console	Content-Security-Policy blocking script	Allow `cdn.stockisto.com` in your theme's `script-src` (rare on default Shopify)

FAQ

Do I need to install a Shopify app?

No. This method pastes your snippet into Shopify's native Custom Liquid section — there is no app to install and no app review.

Does it slow down my store?

The embed script loads asynchronously and fetches data lazily, so it doesn't block your product pages from rendering.

Can I show it on every product?

Yes. Add the product snippet once to your Products template — Shopify renders it on every product and fills in each product's SKU automatically.