Context
Hydrogen's July 30, 2026 developer preview adds official Shopify Inbox support through ShopifyScripts and the <shopify-chat> web component:
<ShopifyScripts
shop={{shopId, storefrontId, myshopifyDomain}}
inbox
/>
<shopify-chat />
Release notes: https://hydrogen.shopify.dev/update/developer-preview-release-notes-july-30-2026
Pilot currently uses the legacy shopifyChatV1.js loader in app/components/shopify-inbox.tsx, requires PUBLIC_SHOPIFY_INBOX_SHOP_ID, and relies on private widget selectors for its custom trigger. This was introduced in #338 and the overlay behavior was added in #447.
Do not implement this against @shopify/hydrogen@preview. The preview is incompatible with the current Pilot stack. Start once Shopify publishes the API in a stable Hydrogen release with migration guidance.
Scope
- Replace the legacy loader with
ShopifyScripts using inbox.
- Render
<shopify-chat> in the root layout.
- Remove
PUBLIC_SHOPIFY_INBOX_SHOP_ID, legacy URL/query construction, and obsolete setup documentation.
- Preserve the overlay visibility behavior and the custom "Message us" action using Shopify's documented public web-component API only.
- Verify CSP, nonce handling, consent, analytics, locale, and client-side navigation.
- Update
.weaverse/docs/shopify-inbox.md, .env.example, and relevant types.
Acceptance criteria
Context
Hydrogen's July 30, 2026 developer preview adds official Shopify Inbox support through
ShopifyScriptsand the<shopify-chat>web component:Release notes: https://hydrogen.shopify.dev/update/developer-preview-release-notes-july-30-2026
Pilot currently uses the legacy
shopifyChatV1.jsloader inapp/components/shopify-inbox.tsx, requiresPUBLIC_SHOPIFY_INBOX_SHOP_ID, and relies on private widget selectors for its custom trigger. This was introduced in #338 and the overlay behavior was added in #447.Do not implement this against
@shopify/hydrogen@preview. The preview is incompatible with the current Pilot stack. Start once Shopify publishes the API in a stable Hydrogen release with migration guidance.Scope
ShopifyScriptsusinginbox.<shopify-chat>in the root layout.PUBLIC_SHOPIFY_INBOX_SHOP_ID, legacy URL/query construction, and obsolete setup documentation..weaverse/docs/shopify-inbox.md,.env.example, and relevant types.Acceptance criteria
@shopify/hydrogenrelease that officially exportsShopifyScripts.<ShopifyScripts inbox>and<shopify-chat>without the legacy loader or Inbox-specific shop ID.