Skip to main content

Hydrogen 2026-10 is now available

The new Hydrogen is now GA: A framework-agnostic JavaScript library to add Shopify commerce to your existing stack, plus skills for coding agents and starters for React Router and Next.js.
Read the full story
Changelog
Subscribe

Surfaces & APIs

Versions

Change type

  1. October 2026

    Surface
    1. Cart updates that result in no changes to the cart no longer trigger carts/update webhooks
      Ajax API

  2. July 2026

    Surface
    1. Storefront API @inContext supports channelId
      Storefront API

  3. June 2026

    Surface
    1. Configure order attribution for sales channel apps
      Admin Extensions
    2. Read a cart line's viewKey from the CartLine type
      Storefront API
    3. Headless checkout SSO is now documented with sso=silent
      Customer Account API
    4. Identify cart lines by view_key in cartLinesUpdate and cartLinesRemove
      Storefront API

  4. May 2026

    Surface
    1. PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION warning code added to CartWarning object
      Storefront API
    2. Publish and unpublish product variants independently from product
      Admin GraphQL API
    3. Ship and pickup in one order now available in feature preview
      Action requiredAdmin Extensions

  5. April 2026

    Surface
    1. New discount fields in the Storefront API's cart types
      DeprecatedStorefront API

  6. February 2026

    Surface
    1. JSON metafield values limited to 128KB
      Breaking changesAdmin GraphQL API

  7. January 2026

    Surface
    1. Storefront API now returns a specific error code when Cart Transform Functions fail
      Storefront API

  8. December 2025

    Surface
    1. Storefront API now returns errors when adding a gift card to a cart with missing or invalid recipient details
      Storefront API

  9. October 2025

    Surface
    1. The cartDiscountCodeUpdate mutation now requires the discountCodes field
      Action requiredStorefront API
    2. Improved concurrency handling in the Cart AJAX API and Storefront Cart GraphQL API
      Storefront API
    3. New: Unlisted Product Status
      Admin GraphQL API
    4. The product variant limit is now 2048 for all merchants
      Admin REST API
    5. Storefront API Cart now supports adding Gift Cards
      Storefront API

  10. September 2025

    Surface
    1. New metafield definition types in GraphQL - article_reference / list.article_reference
      Admin GraphQL API
    2. Your app may be affected by remote products
      Breaking changesTools
    3. @inContext directive supports visitor consent for privacy-compliant checkouts
      Storefront API

  11. August 2025

    Surface
    1. Cart mutations now return error for invalid merchandise configuration
      Storefront API
    2. The cartDeliveryAddressesUpdate mutation now supports removing all addresses from a cart
      Breaking changesStorefront API
    3. New: Support for nested cart lines
      Functions

  12. July 2025

    Surface
    1. MerchandiseSellingPlanNotApplicableOnCompanyLocation warning code for Storefront API
      Storefront API
    2. Storefront API Cart now supports replacing Cart delivery addresses
      Storefront API
    3. Cart quantity limits are now determined by market region
      Storefront API

  13. June 2025

    Surface
    1. Deprecation of POST requests without a Content-Length or Transfer-Encoding: chunked header
      Action requiredAdmin GraphQL API
    2. New pagination limits for Liquid & Storefront GraphQL API
      Breaking changesLiquid
    3. AMAZON_PAY and FACEBOOK_PAY values enumerated in digital wallets
      Admin GraphQL API

  14. May 2025

    Surface
    1. The Storefront API's Cart object now exposes warnings for non-applicable discount codes
      Storefront API
    2. New Storefront API CartErrorCode: BUYER_CANNOT_PURCHASE_FOR_COMPANY_LOCATION
      Storefront API
    3. Deprecating gates types and fields across the GraphQL Admin, Storefront, and Functions APIs
      Action requiredAdmin GraphQL API
    4. The UnitPriceMeasurementMeasuredUnit enum now includes imperial units and counts
      Breaking changesAdmin GraphQL API

  15. April 2025

    Surface
    1. Storefront API now supports cart attributes with blank keys or values
      Storefront API
    2. Stable GraphQL API versions to backfill enum values
      Admin GraphQL API

  16. March 2025

    Surface
    1. Storefront API Cart now exposes selling plan errors
      Storefront API
    2. Checkout APIs will be shut down April 1, 2025
      Action requiredAdmin REST API

  17. January 2025

    Surface
    1. Continuous cart authentication
      Action requiredStorefront API
    2. Filter products by category or taxonomy metafield
      Storefront API
    3. Update to percentage_adjustment field on SellingPlanPercentagePriceAdjustment
      Storefront API
    4. Cart Delivery Address Management
      Action requiredStorefront API
    5. Tax and Duties are deprecated in Storefront Cart API
      Action requiredStorefront API