Vercel integration

How to install and use Sanity's official Vercel integration

Sanity’s Vercel integration lets you connect your Vercel and Sanity projects. The integration lets you manage features like billing and plan management directly in Vercel.

The integration adds environment variables to your Vercel projects with the project ID, a given dataset name, and API tokens for reading and writing data (a read token and a write token). You can use these environment variables to connect your project on Vercel to Sanity’s Content Lake and fetch, create, and update data in it.

• A Vercel account.
• A Vercel project to connect to your Sanity project.

• Go to Vercel's integrations marketplace and follow the instructions.
• We recommend choosing the Native Integration option, as this lets you have a deeper integration with Vercel’s ecosystem.
• Select Install and follow the steps to set up the connection. These are a few key decisions you need to make:
  • Specify a prefix for your environment variables: This guide uses the default, NEXT_PUBLIC_, in the examples below.
  • Select a plan: We offer Free and Growth self-serve options through Vercel at this time. To sign up for an Enterprise plan, contact sales.
  • Select a project name, or use the default suggested one.
• Once the installation completes, follow the Getting Started guide for your framework of choice.

This integration adds your project information as environment variables. You can go to Vercel's documentation to learn more about how to use and configure them.

The project ID will be exposed by the following environment variables in your Vercel project:

• SANITY_PROJECT_ID
• SANITY_STUDIO_API_PROJECT_ID
• NEXT_PUBLIC_SANITY_PROJECT_ID

Project IDs are considered public.

The dataset will be exposed by the following environment variables in your Vercel project:

• SANITY_DATASET
• NEXT_PUBLIC_SANITY_DATASET
• SANITY_STUDIO_API_DATASET

Dataset names are considered public.

The write token and read token are exposed by the following environment variables in your Vercel project:

• SANITY_API_WRITE_TOKEN: a write token provisioned as a server-side secret.
• SANITY_API_READ_TOKEN: a read token, also provisioned as a server-side secret.

Since write tokens give access to changing data in your dataset, they should be considered secret.

Here is an example of a serverless function that runs on Vercel, takes a request with some data, and creates a new document from that data in the Content Lake:

const {createClient} = require('@sanity/client');

const config = {
  projectId: process.env.SANITY_PROJECT_ID,
  dataset: process.env.SANITY_DATASET,
  token: process.env.SANITY_API_WRITE_TOKEN,
  useCdn: false,
  apiVersion: '2026-07-01'
};

async function handleForm(req, res) {
  const payload = JSON.parse(req.body);
  try {
    const result = await createClient(config).create(payload);
    return res.status(200).send('ok');
  } catch (error) {
    return res.status(500).send('error');
  }
}

export default handleForm;

When you sign in to your Studio, or when the CLI prompts you to authenticate, select the sign-in method that matches your Sanity account configuration:

• If you connected a sign-in method earlier: During the Getting Started guide, if you selected "Open in Sanity" on the integration dashboard and linked a sign-in method in Account Settings, use that same method (GitHub or Google).
• If you skipped that step: Use GitHub or Google to log in with the same email address you use for Vercel.
• If neither applies: Open the Sanity management interface from the Vercel integration dashboard, navigate to Account Settings, and add a sign-in method to your account.

If you've signed in to Sanity but don't see the projects or data you expect, you may have multiple accounts.

If you used Sanity before the Vercel integration, you likely already had an account. During integration provisioning, a new account may have been created. To resolve this:

• Add another sign-in method to consolidate your accounts in Account Settings.
• Sign out of both the CLI and Sanity.
• Continue with the Getting Started guide using your original account credentials.

You may have accidentally created a separate account. You have two options:

• Keep the account: Sign out of both Sanity and the CLI, then continue with the Getting Started guide.
• Delete the account: Verify this is an unused account before proceeding. Deleted accounts cannot be recovered.

Before continuing with the Getting Started guide, add another sign-in method in Account Settings to ensure seamless access between sign-in methods.

Projects set up via the Vercel integration need to be managed through the integration dashboard in Vercel.

Deleting a project via Sanity management interface is not supported. Plan changes need to happen through the integration dashboard in Vercel.