Headless storefronts
Choose the JUST widget integration guide for Hydrogen, Next.js, or another custom frontend.
A headless storefront has no Shopify Liquid globals, so the host publishes the shop, locale, cart, consent and logged-in customer explicitly. Choose the guide for the framework that owns your storefront.
Hydrogen
Hydrogen Script, Content Security Policy, CartForm bridge and troubleshooting.
Next.js or custom frontend
Next.js layout, custom cart bridge, analytics and consent.
Both integrations load one module script and mount one standalone
<just-ai-agent> element across route changes. They use the same
attributes and
events.
The widget hides when session creation fails
If the trigger bar never appears, verify the exact *.myshopify.com value in
shop and confirm that the same shop is enabled in the JUST environment
serving the widget script.