Widget reference

Use the saved embed from Install. The page supplies only the product or location keys it needs. An omitted type defaults to where-to-buy; an empty, unknown or retired type renders nothing.

<script
    src="https://cdn.test.stockisto.com/widget.js"
    data-api-base="https://api.test.stockisto.com"
    data-embed="we_0123456789abcdef0123456789abcdef"
    data-sku="7130171"
    async
></script>

01The eight widgets

02Products

One product code, up to 100 characters. An unknown code shows a not-found state, never brand-wide results. data-skus takes up to 6 comma-separated codes.

03Location and list

A fixed data-lat and data-lng search centre prevents a browser location prompt. data-radius is in kilometres. data-per-view controls rows in the inline view.

04Styling

data-theme and the colour overrides take hex colours. data-width accepts full or 200 to 2000 pixels. The browser supplies the font; no web font is loaded.

05Language and consent

Without data-lang, the widget follows the page language, then the browser, then English. Only the literal true in data-analytics-consent enables analytics.

06Content Security Policy

07Boot errors

08Analytics events

With consent, the widget posts events to /api/v1/analytics/events without credentials. The API answers 202. Account attribution requires the page’s domain in Allowed origins.

Seller action events

The event is retailer_cta_click, with widgetEvent cta_click and ctaType call, directions or website.

A quote link that opens a phone number or a website counts as a call or website action.

09Install from npm

Not live yet. The local package is version 2.10.4 with ESM, CommonJS and TypeScript types. npm installation is unavailable until publication is verified. Use the script tag above.

import {
    readConfig,
    fetchRetailers,
    mountStoreListWidget,
} from "@stockisto/widget";

const script = document.createElement("script");
script.dataset.apiBase = "https://api.test.stockisto.com";
script.dataset.stockistoSlug = "your-brand-slug";
script.dataset.sku = "7130171";
const config = readConfig(script);
const { rows } = await fetchRetailers(config, new AbortController().signal);
const container = document.getElementById("where-to-buy");
if (container) mountStoreListWidget(container, rows, config);