Installing Stockisto via Google Tag Manager

Before you begin

You have a Stockisto account and at least one retailer imported
You have edit access to your Google Tag Manager container
Your website is running and accessible

Method 1: Install via Google Tag Manager (recommended)

Step 1: Find your embed snippet

In your Stockisto dashboard → Install tab → copy the HTML snippet. It looks like this:

<script>
    (function (s, t, o, c, k) {
        /* Stockisto embed */
    })("https://cdn.stockisto.com/embed.js", "YOUR_TENANT_ID");
</script>

Snippet includes your Tenant ID

The snippet in your dashboard already contains your unique Tenant ID — don't replace or modify it. Each account has a different snippet.

Step 2: Create a new tag in GTM

Open Google Tag Manager → Tags → New
Click Tag Configuration → choose Custom HTML
Paste your Stockisto snippet into the HTML field
Check ✅ Support document.write

Step 3: Set trigger

Click Triggering → Choose a trigger → All Pages
Click Save and name your tag (e.g. "Stockisto Embed")

Step 4: Preview and verify

Click Preview in GTM → enter your website URL
Open the page — you should see the Stockisto locator widget loading
Open browser console (F12) and check for [Stockisto] log messages

No widget visible?

Check that your page has a <div id="stockisto-locator"> element. The embed script injects into that container. If the div is missing, the widget won't render.

Step 5: Publish your GTM container

Click Submit in GTM → add a version name (e.g. "Add Stockisto")
Click Publish

Method 2: Direct HTML install

If you're not using GTM, paste the snippet directly before the closing </body> tag in your website's HTML template.

Verifying the installation

After publishing, return to your Stockisto dashboard → Install tab → click Check Installation.

If the check passes, you'll see ✅ Installation verified and a timestamp.

If it fails, see Troubleshooting below.

Troubleshooting

Problem	Likely cause	Fix
"No events received in 24h"	Snippet not firing	Re-check GTM trigger; publish GTM container
Widget not visible	Missing container div	Add `<div id="stockisto-locator"></div>` to your page
Check fails immediately	Wrong domain	Verify the domain in your Stockisto account settings matches your site URL
Events arriving but locator blank	Retailer data not published	Publish your locator in Stockisto dashboard
CSP error in console	Content-Security-Policy blocking script	Add `cdn.stockisto.com` to your CSP `script-src` allowlist

FAQ

Does Stockisto slow down my website?

The embed script loads asynchronously — it does not block your page from rendering.

Can I install on multiple pages?

Yes. The snippet should be on every page where you want the locator to appear. Most customers install it site-wide via GTM.

What if I use a custom domain for my locator?

Contact support to configure a custom domain (e.g. locator.yourbrand.com). The same GTM snippet works after the domain is configured.