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. Detect when a POS extension screen finishes navigating
      POS Extensions
    2. Identify the published version running in a POS extension
      POS Extensions
    3. New owner_type field for metafield declarations in Checkout and Customer Account UI extensions, required in 2027-01
      Action requiredCheckout UI
    4. Cart mutations reject unconfirmed writes in POS UI extensions 2026-10
      Breaking changesPOS Extensions

    5. More control over commerce updates with Next Gen Events

      Fewer deliveries, richer payloads, no follow-up queries: Events is a declarative replacement for classic webhooks, now generally available across 18 topics.

      Events & webhooks
    6. New Shop Campaigns metrics and dimensions in ShopifyQL API version 2026-10
      ShopifyQL
    7. Rollouts queries and webhooks in the Admin GraphQL API
      Admin GraphQL API
    8. Discounts can now be included in Rollouts
      Action requiredAdmin GraphQL API
    9. Orders webhooks now include selling_plan_id on line items
      Events & webhooks
    10. New fiscalDeviceIdentifier field on PointOfSaleDevice
      Admin GraphQL API
    11. Added parseWarnings to ShopifyqlQueryResponse
      Admin GraphQL API
    12. The orderCancel mutation now returns a structured jobResult
      Admin GraphQL API
    13. SMS marketing consent now available on the CustomerPhoneNumber object
      Action requiredAdmin GraphQL API
    14. New SubscriptionContractCalculation API for subscription management
      Action requiredAdmin GraphQL API
    15. Inventory shipment webhooks include inventory transfer IDs
      Events & webhooks
    16. Updated function syntax on the segment query language
      Breaking changesAdmin GraphQL API
    17. Return policy profiles are now available in the GraphQL Admin API
      Admin GraphQL API
    18. New APIs for buyer-requested order edits
      Admin GraphQL API
    19. New tax fields for return shipping fees in the GraphQL Admin API
      Admin GraphQL API

  2. September 2026

    Surface
    1. Use app intents for your discount app
      Functions
    2. Shopify Payments Balance Transaction GraphQL type supports currency conversion type
      Admin GraphQL API
    3. New translatable boolean field for Metafield GraphQL Object
      Admin GraphQL API
    4. Adding a canceled receive action to the inventory shipments API
      Admin GraphQL API
    5. Removed session.currentSession.staffMemberId from POS UI Extensions (2026-10)
      Breaking changesPOS Extensions
    6. Purchase Order Read API
      Admin GraphQL API
    7. Query market hierarchies with the GraphQL Admin API
      Admin GraphQL API
    8. New Pricing audit trail for contextual product variant prices
      Admin GraphQL API
    9. Delivery options in Shopify Functions input now expose their metafields
      Functions
    10. Variants now support multiple barcodes
      Action requiredAdmin GraphQL API
    11. Customer Address APIs now support countryCode
      DeprecatedCheckout UI
    12. New paymentInstrumentSendAddEmail mutation emails customers a link to add a payment method for a subscription, order, or draft order
      Admin GraphQL API

  3. August 2026

    Surface
    1. The orderCreate mutation now supports multiple tracking numbers for each fulfillment
      Admin GraphQL API

  4. July 2026

    Surface
    1. createdAt is now available on the Customer object in Shopify Functions
      Functions
    2. Updating an order's shipping address recalculates taxes as of API version 2026-10
      Breaking changesAdmin GraphQL API
    3. SubscriptionContractCalculation API now available in early access
      Admin GraphQL API
    4. Invalid metafield queries now return errors in the GraphQL Admin API
      Breaking changesAdmin GraphQL API

    5. Full-stack capabilities to power app analytics

      Shopify Analytics is now a full-stack platform for apps. Model, query, embed, and enrich analytics on Shopify without managing your own data infrastructure.

      Admin GraphQL API
    6. Storefront API @inContext supports channelId
      Storefront API
    7. productId, title,variantSku, and variantTitle fields added to ExchangeLineItem
      Admin GraphQL API
    8. Customer Account API Customer.lastIncompleteCheckout and Checkout types removed in 2026-10
      Breaking changesCustomer Account API
    9. OrderDisplayFulfillmentStatus now returns FULFILLMENT_NOT_REQUIRED for orders with no items to fulfill
      Breaking changesAdmin GraphQL API

  5. June 2026

    Surface
    1. Carrier services will no longer be automatically added to the default shipping profile
      Breaking changesAdmin GraphQL API
    2. DraftOrderDiscountNotAppliedWarning.priceRule removed in GraphQL Admin API 2026-10
      Breaking changesAdmin GraphQL API
    3. Removal of ITEM_NOT_STOCKED_AT_LOCATION error
      Breaking changesAdmin GraphQL API