Quick start — install the embed
Your install snippet lives in the dashboard under Integration → Install & health, with your store id already filled in. It looks like this:
<script async src="https://poneva.com/widget/embed.js?store=YOUR_STORE_ID"></script>Paste it into your storefront's <head> (or your tag manager). That is the entire install
— the same snippet powers every capability you later turn on.
What happens once it's on your site
- The loader is silent and safe. It loads asynchronously, never blocks page render, and never throws errors into your site. It fetches your store's published configuration from Poneva and only renders something when your Storefront AI is ready and the widget is switched on in your dashboard. Until then, shoppers see your unchanged site.
- Install detection is automatic. The snippet reports a lightweight heartbeat on load and then sparingly (about every five minutes), so within a few minutes your dashboard Overview and the Install & health page flip the install chip from "Script not detected yet" to "Script live". Both pages also show a durable "last seen" time, so a brief network blip never reads as uninstalled — and the record stays even if heartbeats pause. The heavy per-capability runtime health breakdown lives on Install & health.
- "Script live" is not "live to shoppers". The install chip only confirms that the snippet is on your site and reaching us. Each capability stays Off to shoppers until you turn it on — so you can confirm the script is installed first, then enable capabilities one at a time and watch each verify.
- The Shopping Assistant appears when you turn it on. Shoppers get a launcher that opens a chat panel; the assistant answers from your real catalog and shows live product cards, with add-to-cart on supported stores. See Shopping Assistant for the settings.
- Agentic Kits render on your search pages from the same snippet. When you publish the search surface, the loader also mounts the Agentic Kits band above your native results — no second tag, no extra code. It appears alongside your existing search results, and you choose where it lands in the Agentic Kits setup. Each capability is independent: the band still renders even if you keep the chat assistant switched off, and the assistant still renders even if you never publish Kits.
- Agent Support can run on its own. The same snippet also powers Agent Support, which can add a standalone support launcher even with the Shopping Assistant switched off — you turn on only what you want.
Preview before going live
Once your store is ready, opening any page on your site with ?skaii_preview=1 appended
to the URL shows you the widget even while it is still switched off for shoppers.
The widget on/off toggle, the snippet, and placement options also live under Shopping Assistant → Settings → Install & placement.