GraphQL Client in Next.js

As GraphQL returns JSON data over HTTP, you can use any HTTP client to integrate with a GraphQL endpoint. It is, however, easier to use a dedicated library that comes with some additional features already configured, such as in-memory cache, error handling, etc.

You need to configure a GraphQL client in our Next.js application in order to send queries and execute mutation against the Saleor API. In this tutorial, we will be using Apollo, one of the most popular GraphQL clients for JavaScript. Since we are writing TypeScript, we will also leverage the GraphQL Code Generator library. This approach will allow us to automatically generate the TypeScript types for our application from the Saleor API schema.

Configure Apollo Client

  1. In your Terminal, go to the root folder of the storefront project and install the Apollo Client:
npm install @apollo/client graphql


pnpm add @apollo/client graphql

Let's start by creating an Apollo client instance that points to the Saleor GraphQL API. In this tutorial, we will use the following API endpoint provided by the Saleor Cloud.

Feel free to change it to your own Saleor server instance. You can find the url of your instance on the list of environments in your Saleor account.

Saleor server instance URL.
Saleor server instance URL.

The GraphQL client is available in the application via the ApolloProvider component which provides the connection to the GraphQL endpoint. We wrap our application with the Apollo provider at the highest level in the component tree so that it's available for any child component below.

Go to pages/_app.tsx file in your storefront project and update the existing code with changes below:

import type { AppProps } from "next/app";

import { ApolloProvider, ApolloClient, InMemoryCache } from "@apollo/client";

import "../styles/globals.css";

const client = new ApolloClient({
  uri: "",
  cache: new InMemoryCache(),

export default function MyApp({ Component, pageProps }: AppProps) {
  return (
    <ApolloProvider client={client}>
      <Component {...pageProps} />

The ApolloClient instance requires a uri pointing to a Saleor API endpoint and cache that in this case will be simply in-memory.

Help us improve our docs. Edit this page on GitHub