---
title: Shop Minis May June 2026 update - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/shop-minis-may-june-2026-update'
  md: 'https://shopify.dev/changelog/shop-minis-may-june-2026-update.md'
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Shop Minis
      handle: shop-minis
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-07-01T10:52:36-04:00'
  postedAt: '2026-07-01T16:05:00-04:00'
  updatedAt: '2026-07-01T11:00:38-04:00'
  effectiveAt: '2026-07-02T12:00:00-04:00'
---

July 1, 2026

Tags:

* Shop Minis

# 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:**

```tsx
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

| Package | Version |
| - | - |
| `@shopify/shop-minis-platform` | 0.26.0 |
| `@shopify/shop-minis-react` | 0.28.0 |
| `@shopify/shop-minis-cli` | 0.3.21 |

***

## 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.