[ci] release 2026.1.0

[shopify-github-actions-access]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@shopify/hydrogen-react@2026.1.0

Major Changes

• Update Storefront API and Customer Account API to version 2025-10 (#3352) by @fredericoo

Minor Changes

• Add visitorConsent support to @inContext directive for Storefront API parity (#3408) by @kdaviduik

  Note: Most Hydrogen storefronts do NOT need this feature.

  This API addition provides Storefront API 2025-10 parity for the visitorConsent parameter in @inContext directives. However, if you're using Hydrogen's analytics provider or Shopify's Customer Privacy API (including third-party consent services integrated with it), consent is already handled automatically and you don't need to use this.

  This feature is primarily intended for Checkout Kit and other non-Hydrogen integrations that manage consent outside of Shopify's standard consent flow.

  What it does:
  When explicitly provided, visitorConsent encodes buyer consent preferences (analytics, marketing, preferences, saleOfData) into the cart's checkoutUrl via the _cs parameter.

Patch Changes

• Add parent prop to AddToCartButton for nested cart lines (#3398) by @fredericoo

  The AddToCartButton component now accepts an optional parent prop, allowing you to add items as children of an existing cart line. This enables adding warranties, gift wrapping, or other add-ons that should be associated with a parent product.

  Usage

  import {AddToCartButton} from '@shopify/hydrogen-react';
  
  // Add a warranty as a child of an existing cart line (by line ID)
  <AddToCartButton
    variantId="gid://shopify/ProductVariant/warranty-123"
    parent={{parentLineId: 'gid://shopify/CartLine/parent-456'}}
  >
    Add Extended Warranty
  </AddToCartButton>
  
  // Add a warranty as a child of a cart line (by merchandise ID)
  // Useful when you know the product variant but not the cart line ID
  <AddToCartButton
    variantId="gid://shopify/ProductVariant/warranty-123"
    parent={{merchandiseId: 'gid://shopify/ProductVariant/laptop-456'}}
  >
    Add Extended Warranty
  </AddToCartButton>

  Type

  interface AddToCartButtonPropsBase {
    // ... existing props
    /** The parent line item of the item being added to the cart. Used for nested cart lines. */
    parent?: CartLineParentInput;
  }

• Add support for article_reference and list.article_reference metafield types (#3407) by @kdaviduik

  These new metafield types were introduced in Storefront API 2025-10, allowing merchants to reference blog articles in metafields.

@shopify/cli-hydrogen@11.1.8

Patch Changes

• Update Storefront API and Customer Account API to version 2025-10 (#3430) by @kdaviduik

• Add support for Bun's text-based lockfile (bun.lock) introduced in Bun 1.2, and npm's shrinkwrap lockfile (npm-shrinkwrap.json), as alternatives to their respective primary lockfiles (bun.lockb and package-lock.json). (#3430) by @kdaviduik

• Add cartGiftCardCodesAdd mutation (#3430) by @kdaviduik

  New Feature: cartGiftCardCodesAdd

  The skeleton template has been updated to use the new cartGiftCardCodesAdd mutation:

  • Removed UpdateGiftCardForm component from CartSummary.tsx
  • Added AddGiftCardForm component using CartForm.ACTIONS.GiftCardCodesAdd

  If you customized the gift card form in your project, you may want to migrate to the new Add action for simpler code.

  Usage

  import {CartForm} from '@shopify/hydrogen';
  
  <CartForm action={CartForm.ACTIONS.GiftCardCodesAdd} inputs={{giftCardCodes: ['CODE1', 'CODE2']}}>
    <button>Add Gift Cards</button>
  </CartForm>

  Or with createCartHandler:

  const cart = createCartHandler({storefront, getCartId, setCartId});
  await cart.addGiftCardCodes(['SUMMER2025', 'WELCOME10']);

• Add support for nested cart line items (warranties, gift wrapping, etc.) (#3430) by @kdaviduik

  Storefront API 2025-10 introduces parentRelationship on cart line items, enabling parent-child relationships for add-ons. This update displays nested line items in the cart.

  Changes

  • Updates GraphQL fragments to include parentRelationship and lineComponents fields
  • Updates CartMain and CartLineItem to render child line items with visual hierarchy

  Note

  This update focuses on displaying nested line items. To add both a product and its child (e.g., warranty) in a single action:

  <AddToCartButton
    lines={[
      {merchandiseId: 'gid://shopify/ProductVariant/laptop-456', quantity: 1},
      {
        merchandiseId: 'gid://shopify/ProductVariant/warranty-123',
        quantity: 1,
        parent: {merchandiseId: 'gid://shopify/ProductVariant/laptop-456'},
      },
    ]}
  >
    Add to Cart with Warranty
  </AddToCartButton>

@shopify/create-hydrogen@5.0.28

Patch Changes

• Update Storefront API and Customer Account API to version 2025-10 (#3430) by @kdaviduik

• Add support for Bun's text-based lockfile (bun.lock) introduced in Bun 1.2, and npm's shrinkwrap lockfile (npm-shrinkwrap.json), as alternatives to their respective primary lockfiles (bun.lockb and package-lock.json). (#3430) by @kdaviduik

• Add cartGiftCardCodesAdd mutation (#3430) by @kdaviduik

  New Feature: cartGiftCardCodesAdd

  The skeleton template has been updated to use the new cartGiftCardCodesAdd mutation:

  • Removed UpdateGiftCardForm component from CartSummary.tsx
  • Added AddGiftCardForm component using CartForm.ACTIONS.GiftCardCodesAdd

  If you customized the gift card form in your project, you may want to migrate to the new Add action for simpler code.

  Usage

  import {CartForm} from '@shopify/hydrogen';
  
  <CartForm action={CartForm.ACTIONS.GiftCardCodesAdd} inputs={{giftCardCodes: ['CODE1', 'CODE2']}}>
    <button>Add Gift Cards</button>
  </CartForm>

  Or with createCartHandler:

  const cart = createCartHandler({storefront, getCartId, setCartId});
  await cart.addGiftCardCodes(['SUMMER2025', 'WELCOME10']);

• Add support for nested cart line items (warranties, gift wrapping, etc.) (#3430) by @kdaviduik

  Storefront API 2025-10 introduces parentRelationship on cart line items, enabling parent-child relationships for add-ons. This update displays nested line items in the cart.

  Changes

  • Updates GraphQL fragments to include parentRelationship and lineComponents fields
  • Updates CartMain and CartLineItem to render child line items with visual hierarchy

  Note

  This update focuses on displaying nested line items. To add both a product and its child (e.g., warranty) in a single action:

  <AddToCartButton
    lines={[
      {merchandiseId: 'gid://shopify/ProductVariant/laptop-456', quantity: 1},
      {
        merchandiseId: 'gid://shopify/ProductVariant/warranty-123',
        quantity: 1,
        parent: {merchandiseId: 'gid://shopify/ProductVariant/laptop-456'},
      },
    ]}
  >
    Add to Cart with Warranty
  </AddToCartButton>

@shopify/hydrogen@2026.1.0

Patch Changes

• Fixed bug where file paths containing spaces were causing errors with virtual routes by decoding URL-encoded paths (#3436) by @itsjustriley

skeleton@2026.1.0

Major Changes

• Update Storefront API and Customer Account API to version 2025-10 (#3430) by @kdaviduik

Patch Changes

• Add support for Bun's text-based lockfile (bun.lock) introduced in Bun 1.2, and npm's shrinkwrap lockfile (npm-shrinkwrap.json), as alternatives to their respective primary lockfiles (bun.lockb and package-lock.json). (#3430) by @kdaviduik

• Add cartGiftCardCodesAdd mutation (#3430) by @kdaviduik

  New Feature: cartGiftCardCodesAdd

  The skeleton template has been updated to use the new cartGiftCardCodesAdd mutation:

  • Removed UpdateGiftCardForm component from CartSummary.tsx
  • Added AddGiftCardForm component using CartForm.ACTIONS.GiftCardCodesAdd

  If you customized the gift card form in your project, you may want to migrate to the new Add action for simpler code.

  Usage

  import {CartForm} from '@shopify/hydrogen';
  
  <CartForm action={CartForm.ACTIONS.GiftCardCodesAdd} inputs={{giftCardCodes: ['CODE1', 'CODE2']}}>
    <button>Add Gift Cards</button>
  </CartForm>

  Or with createCartHandler:

  const cart = createCartHandler({storefront, getCartId, setCartId});
  await cart.addGiftCardCodes(['SUMMER2025', 'WELCOME10']);

• Add support for nested cart line items (warranties, gift wrapping, etc.) (#3430) by @kdaviduik

  Storefront API 2025-10 introduces parentRelationship on cart line items, enabling parent-child relationships for add-ons. This update displays nested line items in the cart.

  Changes

  • Updates GraphQL fragments to include parentRelationship and lineComponents fields
  • Updates CartMain and CartLineItem to render child line items with visual hierarchy

  Note

  This update focuses on displaying nested line items. To add both a product and its child (e.g., warranty) in a single action:

  <AddToCartButton
    lines={[
      {merchandiseId: 'gid://shopify/ProductVariant/laptop-456', quantity: 1},
      {
        merchandiseId: 'gid://shopify/ProductVariant/warranty-123',
        quantity: 1,
        parent: {merchandiseId: 'gid://shopify/ProductVariant/laptop-456'},
      },
    ]}
  >
    Add to Cart with Warranty
  </AddToCartButton>

• Updated dependencies [722915130410086bc7af22215ba57ee77aa14156]:

  • @shopify/hydrogen@2025.10.1

[shopify]

Oxygen deployed a preview of your changeset-release/main branch. Details:

Storefront	Status	Preview link	Deployment details	Last update (UTC)
Skeleton (skeleton.hydrogen.shop)	✅ Successful (Logs)	Preview deployment	Inspect deployment	February 3, 2026 5:40 PM
custom-cart-method	✅ Successful (Logs)	Preview deployment	Inspect deployment	February 3, 2026 5:40 PM
classic-remix	✅ Successful (Logs)	Preview deployment	Inspect deployment	February 3, 2026 5:40 PM
metaobjects	✅ Successful (Logs)	Preview deployment	Inspect deployment	February 3, 2026 5:40 PM
third-party-queries-caching	✅ Successful (Logs)	Preview deployment	Inspect deployment	February 3, 2026 5:40 PM
sitemap	✅ Successful (Logs)	Preview deployment	Inspect deployment	February 3, 2026 5:40 PM

Learn more about Hydrogen's GitHub integration.