Developer preview release notes: September 2, 2026

New

Variant links

Hydrogen now reads Shopify's ?variant= product links and sends the shopper to that variant. It used to ignore the parameter and show the default variant at the default price. Pass routeTemplates to handleShopifyRoutes to turn it on.

Product option links

Product option links have a builder now. buildProductSelectionSearchParams() emits option params by default, or a shareable ?variant= link with style: "variant", and keeps stale selections from piling up in the query string.

Cart refresh

You can now reconcile the client-side cart after something outside Hydrogen's cart forms changes it, like a cart your server created with cartCreate or your own direct Storefront API mutation. In React and Vue, call refresh() from useCartActions(). Everywhere else, call CartStore.refresh().

Local HTTPS certificates

Hydrogen creates the certificates for local HTTPS, so testing Customer Account login no longer starts with generating your own. The localHttps() Vite plugin does it on first run. Without the plugin, run npx hydrogen certs install, and npx hydrogen certs uninstall removes them.

Changed

• Redirects registered on a route can set their own status code.
• getSelectedProductOptions no longer returns variant as a product option.
• The https:dev script is now dev:https.
• The cart and product page skills cover the new APIs, and collection filter guidance now includes price ranges.

Fixes

Changing a collection filter or the sort order resets the before and after pagination cursors. A stale cursor could point past the end of the new result set.

Analytics from WebMCP tools are recorded on headless storefronts now.

Migration

For migration guidance, compare the commits that bracket this release. The diff shows the changes between the previous preview and this release:

Code Example
Copy
git diff d91af14a4..01b010241