April 2025 release

Welcome to the April release! In this release, we bring fixes to internationalization, cart functionality, and template improvements. Let's dive into what's new.

Internationalization Improvements

Fixed duplicate content issues with internationalized product handles (#2821). Previously, translated product handles could create duplicate content at multiple URLs. For example:

https://hydrogen.shop/de-de/products/das-chaos
https://hydrogen.shop/de-de/products/the-havoc

The starter template now redirects to the localized URL, improving SEO and user experience.

Cart and Customer Account Enhancements

• Fixed cart quantity validation (#2855)
• Improved customer account logout handling (#2843)
  • Now clears all session data by default
  • Added keepSession option for custom data retention

Product Management Updates

• Deprecated <VariantSelector /> (#2837)
  • We recommend using the getProductOptions utility instead.
  • Please refer to the implementation in our skeleton template, which has already made this transition
• Refactored ProductItem into a separate component (#2872)

Cart Delivery Features

Added support for cart delivery address mutations (#2850):

• cartDeliveryAddressesAdd

• cartDeliveryAddressesRemove

• cartDeliveryAddressesUpdate

Migration Notes

Upgrading from VariantSelector

When migrating from VariantSelector to getProductOptions:

1. Update SFAPI product query with new fields:

• • encodedVariantExistence
  • encodedVariantAvailability

1. Remove VARIANTS_QUERY from loadDeferredData
2. Update Product component to use getAdjacentAndFirstAvailableVariants
3. Implement URL parameter handling for variant selection

For more detailed instructions, please refer to the changelog.

To take advantage of all the latest features and improvements in Hydrogen, just run npx shopify hydrogen upgrade. That’s it for the April release!