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. January 2025

    Surface
    1. New validations on function input query variables metafields
      API
    2. New fields to represent product bundles in a grouped view
      GraphQL Admin API
    3. Filter products by category or taxonomy metafield
      Storefront API
    4. Minimum requirement is now optional on automatic discounts
      GraphQL Admin API
    5. New customer input field for the OrderCreate mutation
      GraphQL Admin API
    6. Introduce concatenatedOriginContract to subscriptionLine
      GraphQL Admin API
    7. Unused PriceListUserErrorCode values removed
      Breaking changesGraphQL Admin API
    8. Update to percentage_adjustment field on SellingPlanPercentagePriceAdjustment
      Storefront API
    9. New delivery promise participants API
      GraphQL Admin API
    10. Deprecation of storefrontCustomerAccessTokenCreate Mutation
      DeprecatedCustomer Account API
    11. Update in orders webhook to view bundles and their components
      GraphQL Admin API
    12. Combined Listings update mutation error improvements
      GraphQL Admin API
    13. Cart Delivery Address Management
      Action requiredStorefront API
    14. Fulfillment Hold Access Update For Node Queries
      Action requiredGraphQL Admin API
    15. New customer's webhook and changes to existing customer's webhooks payload
      Action requiredEvents & webhooks
    16. Change to FulfillmentOrderSortKeys
      DeprecatedGraphQL Admin API
    17. Introduce 3DS support for verifications
      Action requiredPayments Apps API
    18. BXGY discount support for subscriptions
      GraphQL Admin API
    19. Apply multiple holds to a single fulfillment order
      Action requiredGraphQL Admin API
    20. Addition of 'paymentDetails' field in verificationSessionResolve mutation.
      Payments Apps API
    21. Enhanced variant query limits for single product queries
      GraphQL Admin API
    22. Tax and Duties are deprecated in Storefront Cart API
      Action requiredStorefront API
    23. ReverseFulfillmentOrder.order field is nullable as of 2025-01
      GraphQL Admin API
    24. Support Delayed Fulfillment Status in GraphQL API
      GraphQL Admin API
    25. Admin access input is now optional when setting metafield definition access
      GraphQL Admin API
    26. New validation against duplicate handles in productCreate, productUpdate, and productSet mutation inputs
      Action requiredGraphQL Admin API
    27. Introduce a tax_exempt field associated to a CompanyLocation
      GraphQL Admin API

  2. December 2024

    Surface
    1. Events and Origins in Store Credit Account Transactions
      GraphQL Admin API
    2. Deprecate customer_payment_method_remote_credit_card_create
      DeprecatedPayments Apps API
    3. Adding new revocation reasons for payment methods
      Payments Apps API
    4. Removal of deprecated shop fields
      Breaking changesGraphQL Admin API
    5. Improved productTags, productVendors, productTypes
      GraphQL Admin API
    6. Print API will be available for POS Extensions
      POS Extensions
    7. New inventoryPolicy argument for billing mutations
      GraphQL Admin API
    8. New LocalizationExtensionKeys value for Mexico
      GraphQL Admin API
    9. New revocation reasons for payment methods for 2025-01
      GraphQL Admin API
    10. Search discountNodes by exact discount code in the GraphQL Admin API
      GraphQL Admin API
    11. Changes to ScriptTag displayScope field on Admin GraphQL API
      Action requiredGraphQL Admin API
    12. Product image resource in REST now returns a media image GID to streamline migration to GraphQL
      Action requiredAPI
    13. Returns now supported in Customer Accounts API
      Customer Account API
    14. Using custom ids and handles in product and customer lookups
      GraphQL Admin API
    15. Adding unique values to metafields
      GraphQL Admin API
    16. Improved billing attempt error handling for subscriptions in Selling Plan API
      GraphQL Admin API
    17. Set custom prices in draft orders
      GraphQL Admin API
    18. Simplifying how metafield and metaobject permissions work
      Action requiredGraphQL Admin API
    19. Admin REST API product image is now deprecated
      DeprecatedAdmin REST API
    20. Customize line items in Checkout and Customer Accounts order summary using new Checkout Branding API settings
      GraphQL Admin API
    21. PrivateMetafield is now deprecated
      Action requiredGraphQL Admin API

  3. November 2024

    Surface
    1. Add PickupAddress for subscription contracts in customer API
      Customer Account API
    2. manualPaymentGateway field added to orderTransaction object
      GraphQL Admin API
    3. Conditionally disable gift cards in checkout using custom logic with the Payment Customization API
      Action requiredAPI
    4. Remove metafieldDelete in favor of metafieldsDelete
      Action requiredGraphQL Admin API
    5. GraphQL Over HTTP
      GraphQL Admin API
    6. Content type application/graphql is deprecated
      Action requiredGraphQL Admin API
    7. Removing multiLocation field from ShopFeatures
      Action requiredGraphQL Admin API

  4. October 2024

    Surface
    1. Update to fulfillmentHold.heldByApp field from fulfillmentHold.heldBy field
      Action requiredGraphQL Admin API