Skip to main content

createStorefrontClient

The createStorefrontClient() function creates helpers that enable you to quickly query the Shopify Storefront API.

When used on the server, it is recommended to use the privateStorefrontToken prop. When used on the client, it is recommended to use the publicStorefrontToken prop or consider using <ShopifyProvider/> instead.

Anchor to createStorefrontClient
createStorefrontClient(
input1
)

Anchor to createStorefrontClient-parametersParameters

Anchor to input1
input1
required

Anchor to createStorefrontClient-returnsReturns

Examples

Client Example in NextJS

import {createStorefrontClient} from '@shopify/hydrogen-react';

export const client = createStorefrontClient({
storeDomain: 'https://{store-name}.myshopify.com',
storefrontApiVersion: '2025-10',
privateStorefrontToken: '{private token for server-side requests}',
});

// in another file where you need to make queries, for example in NextJS server-side:

// a Storefront API query
const GRAPHQL_QUERY = `
query {
shop {
name
}
}
`;

// make the request
export async function getServerSideProps() {
// Get the Storefront API url
const response = await fetch(client.getStorefrontApiUrl(), {
body: JSON.stringify({
query: GRAPHQL_QUERY,
}),
// Generate the headers using the private token. Additionally, you can pass in the buyer's IP address from the request object to help prevent bad actors from overloading your store.
headers: client.getPrivateTokenHeaders({buyerIp: '...'}),
method: 'POST',
});

if (!response.ok) {
throw new Error(response.statusText);
}

const json = await response.json();

return {props: json};
}

Anchor to RelatedRelated

ShopifyProvider
Was this page helpful?