Shop Minis May June 2026 update

New Features

Product variant intents

The React SDK added typed product variant intent hooks for selecting variants, adding variants to cart, and sending buyers to express checkout:

• useSelectVariant wraps select:shopify/ProductVariant.
• useAddToCart wraps add_to_cart:shopify/ProductVariant.
• useBuyNow wraps buy_now:shopify/ProductVariant.

These hooks can open the native Shop variant selector sheet over the Mini WebView when a Mini has a product ID but needs the buyer to pick a variant or quantity. Results distinguish successful actions, user dismissal, host errors, navigation to PDP, and referral-product handoffs.

Usage:

const {addToCart} = useAddToCart()

const result = await addToCart({productId})

if (result.code === 'ok') {
  switch (result.data.outcome) {
    case 'added_to_cart':
      break
    case 'navigated_to_product':
      break
    case 'redirected_to_product':
      break
  }
}

Build verification during submit

The CLI now runs Minis build verification as part of submit. The verification system was also split into per-check orchestration with human-readable progress and JSON output support. Current checks cover dependency validation, ESLint disables, ESLint, TypeScript, build output, and manifest validation.

Scoped hook setup warnings

The CLI now warns when a Mini uses scoped SDK hooks before completing the required setup. This gives partners earlier feedback when code uses features that depend on declared scopes or account setup.

---

Documentation Updates

Intent resolution documentation

Docs were added or fixed for useResolveIntent, including examples that show returning typed intent results to Shop.

verify-build and submit documentation

The Shop Minis command docs now include verify-build, build verification usage, and how submit relates to build verification.

Product reviews documentation

Docs were added for useProductReviews, covering paginated review fetching by product ID.

Allowed dependency documentation

The allowed dependency docs were reconciled with CLI source and updated with newly allowed packages, including tw-animate-css.

---

Deprecations

usePopularProducts

usePopularProducts is deprecated and now emits a development warning. There is no one-to-one replacement. Use useRecommendedProducts for personalized discovery or useProductSearch for search-driven discovery.

---

Package Versions

---

Other Changes

• The allowed dependency set was expanded with newer partner-available packages, including tw-animate-css.
• Build verification now includes manifest validation and clearer per-check output.
• The Shop Minis CLI and docs were kept in sync for allowed dependency and build verification behavior.

---

Summary

May-June 2026 brings three net-new updates:

1. Richer commerce actions through typed product variant intents and native variant selection.
2. Stronger submission quality gates with build verification during submit.
3. Clearer migration guidance through usePopularProducts deprecation messaging and updated docs.

For questions or feedback, reach out to the Shop Minis team.