Skip to content

Ask the docs beta

Answers come from this documentation only, with sources. For account-specific issues, the docs route you to the right owner.

Find your install path

Installing Dialog has two concerns, and they don’t always live in the same place:

  • Data ingestion — uploading your product catalog (and optionally blog / pages) so the assistant can answer accurately.
  • Frontend integration — embedding the assistant widget on your storefront so visitors can use it.

Some paths cover both at once (Shopify app, Prestashop module). Other stacks need you to mix-and-match (e.g. Shopify headless: app handles data ingestion, you embed the frontend yourself).

Find your stack below. Each card links to the two pages you’ll need: one for data ingestion, one for the frontend embed.

Answers to the routing questions we get most

Section titled “Answers to the routing questions we get most”

“Shopify app, GTM, or SDK — which one?” If your store runs on Shopify, it’s always the Shopify app — never GTM, never the bare SDK (except headless, below). On Prestashop, always the module. GTM exists only for stores that are on neither platform and have no frontend developer — it’s a beta, last-resort path with real trade-offs.

“We’re on headless Shopify (Hydrogen, Next.js…). What goes where?” Split the two concerns: install the Shopify app for catalog sync, then embed the widget with @askdialog/dialog-react, @askdialog/dialog-vue, or the SDK. The app block can’t render outside the Online Store renderer. Details in Install on Shopify → Headless.

“I only need the catalog wired.” Go to Catalog integration. Shopify and Prestashop sync automatically; everything else uploads via the API following the catalog schema.

“The widget is live — I only need tracking.” Go to the Tracking overview. It tells you, per install path, which events are automatic and which two site-level events your team wires.

“API, SDK, React package, Vue package — what’s each one for?” The REST API is server-side, for catalog and content upload only. The SDK and the React / Vue packages are frontend, for embedding the widget. Full routing table in the Developers overview.

“What can I configure myself, and what needs a developer?” Everything in the Dialog dashboard is self-serve: training documents, guidelines, assistant identity, visual customization, Personal Shopper. Code is needed only for custom-storefront embeds, GTM container wiring, cart-UI refresh glue, and custom catalog uploads. The full ownership map is in Before you contact support.

What your team has to do depends on the path:

  • Shopify or Prestashop merchant → you install the app or module yourself from the back office. No developer needed for a standard setup; a few minutes of clicking. Your catalog syncs automatically.
  • Shopify legacy theme (< 2.0) → same install, but a developer (yours or your agency’s) needs to paste a few snippets into your theme — usually under an hour.
  • Headless Shopify, or any other custom storefront with frontend developers → your developers integrate Dialog into your storefront codebase. They get full control over how the assistant connects to your cart and your product pages, which means it fits cleanly into your existing checkout flow. Plan for a few hours to a day of frontend work.
  • Non-Shopify / non-Prestashop, no frontend developers available → use Google Tag Manager (Beta). You set it up from your GTM account, no code touched. Trade-off: the widget loads after the rest of the page, so visitors get a delay and a layout shift, and it won’t quite match your site’s look. Last-resort path — use it only when an SDK install isn’t possible.

Frontend integration options for custom or headless stacks

Section titled “Frontend integration options for custom or headless stacks”

If your data ingestion is handled but you still need to embed the assistant on a custom frontend, share this with your developers:

  • React@askdialog/dialog-react — drop-in DialogProductBlock and DialogInput.
  • Vue 3@askdialog/dialog-vue — same components, Vue flavor.
  • Other JS frameworks (Svelte, SolidJS, Lit, vanilla, server-side templating like Twig / Blade / ERB) → @askdialog/dialog-sdk — vanilla SDK, the team builds the UI shell around it.

The add-to-cart UI refresh (cart icon, bubble, mini-cart, drawer) is the single most common issue, on every platform. After you install Dialog, open the assistant on a product page, add a product, and check that your cart UI updates without a page reload. If it doesn’t, see Add to cart issues — the fix differs by install path.