Skip to content

Commit d46c886

Browse files
authored
[2026-01] Storefront & Customer Account API version update (#3434)
* feat: [2026-01] Update Storefront API and Customer Account API Update Storefront API and Customer Account API from 2025-10 to 2026-01. This is the quarterly API version update aligned with Shopify's API release schedule. * run npm install
1 parent 0723a6f commit d46c886

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

47 files changed

+811
-107
lines changed

.changeset/tidy-cats-dance.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
'@shopify/hydrogen': major
3+
'@shopify/hydrogen-react': major
4+
'@shopify/cli-hydrogen': patch
5+
'@shopify/create-hydrogen': patch
6+
'skeleton': major
7+
---
8+
9+
Updated to Storefront API 2026-01 and Customer Account API 2026-01.
10+
11+
This is a quarterly API version update aligned with Shopify's API release schedule.
12+
13+
**Action Required**: The `cartDiscountCodesUpdate` mutation now requires the `discountCodes` argument. If you have custom cart discount code logic, verify your mutations include this field.
14+
15+
Review the changelogs for other changes that may affect your storefront:
16+
- [Storefront API 2026-01 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-01&api_type=storefront-graphql)
17+
- [Customer Account API 2026-01 changelog](https://shopify.dev/changelog?filter=api&api_version=2026-01&api_type=customer-account-graphql)

package-lock.json

Lines changed: 7 additions & 7 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

packages/hydrogen-react/codegen.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ import {
44
customerAccountApiCustomScalars,
55
} from './src/codegen.helpers';
66

7-
const SF_API_VERSION = '2025-10';
8-
const CA_API_VERSION = '2025-10';
7+
const SF_API_VERSION = '2026-01';
8+
const CA_API_VERSION = '2026-01';
99

1010
const storefrontAPISchema: CodegenConfig['schema'] = {
1111
[`https://hydrogen-preview.myshopify.com/api/${SF_API_VERSION}/graphql.json`]:

packages/hydrogen-react/customer-account.schema.json

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

packages/hydrogen-react/docs/generated/generated_docs_data.json

Lines changed: 28 additions & 20 deletions
Large diffs are not rendered by default.

packages/hydrogen-react/docs/generated/generated_static_pages.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@
3535
"type": "Generic",
3636
"anchorLink": "authentication",
3737
"title": "Authentication",
38-
"sectionContent": "To use Hydrogen React, you need to authenticate with and make requests to the [Storefront API](/docs/api/storefront). Hydrogen React includes an [API client](/docs/api/hydrogen-react/2025-10/utilities/createstorefrontclient) to securely handle API queries and mutations.\n\nYou can create and manage Storefront API access tokens by installing the [Headless sales channel](https://apps.shopify.com/headless) on your store.\n\nApps have access to [two kinds of tokens](/docs/api/usage/authentication#access-tokens-for-the-storefront-api): a public API token, which can be used in client-side code, and a private API token, which should only be used in server-side contexts and never exposed publicly.",
38+
"sectionContent": "To use Hydrogen React, you need to authenticate with and make requests to the [Storefront API](/docs/api/storefront). Hydrogen React includes an [API client](/docs/api/hydrogen-react/2026-01/utilities/createstorefrontclient) to securely handle API queries and mutations.\n\nYou can create and manage Storefront API access tokens by installing the [Headless sales channel](https://apps.shopify.com/headless) on your store.\n\nApps have access to [two kinds of tokens](/docs/api/usage/authentication#access-tokens-for-the-storefront-api): a public API token, which can be used in client-side code, and a private API token, which should only be used in server-side contexts and never exposed publicly.",
3939
"sectionCard": [
4040
{
4141
"subtitle": "Install",

packages/hydrogen-react/docs/staticPages/hydrogenReact.doc.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ const data: LandingTemplateSchema = {
4141
anchorLink: 'authentication',
4242
title: 'Authentication',
4343
sectionContent:
44-
'To use Hydrogen React, you need to authenticate with and make requests to the [Storefront API](/docs/api/storefront). Hydrogen React includes an [API client](/docs/api/hydrogen-react/2025-10/utilities/createstorefrontclient) to securely handle API queries and mutations.\n\nYou can create and manage Storefront API access tokens by installing the [Headless sales channel](https://apps.shopify.com/headless) on your store.\n\nApps have access to [two kinds of tokens](/docs/api/usage/authentication#access-tokens-for-the-storefront-api): a public API token, which can be used in client-side code, and a private API token, which should only be used in server-side contexts and never exposed publicly.',
44+
'To use Hydrogen React, you need to authenticate with and make requests to the [Storefront API](/docs/api/storefront). Hydrogen React includes an [API client](/docs/api/hydrogen-react/2026-01/utilities/createstorefrontclient) to securely handle API queries and mutations.\n\nYou can create and manage Storefront API access tokens by installing the [Headless sales channel](https://apps.shopify.com/headless) on your store.\n\nApps have access to [two kinds of tokens](/docs/api/usage/authentication#access-tokens-for-the-storefront-api): a public API token, which can be used in client-side code, and a private API token, which should only be used in server-side contexts and never exposed publicly.',
4545
sectionCard: [
4646
{
4747
subtitle: 'Install',

packages/hydrogen-react/src/CartLineProvider.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ type CartLinePartialDeep = PartialDeep<
1313
export const CartLineContext = createContext<CartLinePartialDeep | null>(null);
1414

1515
/**
16-
* The `useCartLine` hook provides access to the [CartLine object](https://shopify.dev/api/storefront/2025-10/objects/cartline) from the Storefront API. It must be a descendent of a `CartProvider` component.
16+
* The `useCartLine` hook provides access to the [CartLine object](https://shopify.dev/api/storefront/2026-01/objects/cartline) from the Storefront API. It must be a descendent of a `CartProvider` component.
1717
*/
1818
export function useCartLine(): CartLinePartialDeep {
1919
const context = useContext(CartLineContext);

packages/hydrogen-react/src/CartProvider.stories.tsx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,7 @@ function CartComponent() {
228228
const config: ShopifyProviderProps = {
229229
storeDomain: 'hydrogen-preview.myshopify.com',
230230
storefrontToken: '3b580e70970c4528da70c98e097c2fa0',
231-
storefrontApiVersion: '2025-10',
231+
storefrontApiVersion: '2026-01',
232232
countryIsoCode: 'CA',
233233
languageIsoCode: 'EN',
234234
};
@@ -249,7 +249,7 @@ Default.args = {
249249
numCartLines: 30,
250250
/** A callback that is invoked when the process to create a cart begins, but before the cart is created in the Storefront API. */
251251
data: undefined,
252-
/** A fragment used to query the Storefront API's [Cart object](https://shopify.dev/api/storefront/2025-10/objects/cart) for all queries and mutations. A default value is used if no argument is provided. */
252+
/** A fragment used to query the Storefront API's [Cart object](https://shopify.dev/api/storefront/2026-01/objects/cart) for all queries and mutations. A default value is used if no argument is provided. */
253253
cartFragment: undefined,
254254
/** A customer access token that's accessible on the server if there's a customer login. */
255255
customerAccessToken: undefined,

packages/hydrogen-react/src/CartProvider.tsx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -88,9 +88,9 @@ type CartProviderProps = {
8888
onAttributesUpdateComplete?: () => void;
8989
/** A callback that is invoked when the process to update the cart discount codes completes */
9090
onDiscountCodesUpdateComplete?: () => void;
91-
/** An object with fields that correspond to the Storefront API's [Cart object](https://shopify.dev/api/storefront/2025-10/objects/cart). */
91+
/** An object with fields that correspond to the Storefront API's [Cart object](https://shopify.dev/api/storefront/2026-01/objects/cart). */
9292
data?: PartialDeep<CartType, {recurseIntoArrays: true}>;
93-
/** A fragment used to query the Storefront API's [Cart object](https://shopify.dev/api/storefront/2025-10/objects/cart) for all queries and mutations. A default value is used if no argument is provided. */
93+
/** A fragment used to query the Storefront API's [Cart object](https://shopify.dev/api/storefront/2026-01/objects/cart) for all queries and mutations. A default value is used if no argument is provided. */
9494
cartFragment?: string;
9595
/** A customer access token that's accessible on the server if there's a customer login. */
9696
customerAccessToken?: CartBuyerIdentityInput['customerAccessToken'];

0 commit comments

Comments
 (0)