Vercel protection bypass

Bypass protection for automation is a Vercel feature for bypassing authenticated deployments. It requires additional setup to use with Presentation and Studio.

For users of Vercel's Deployment Protection, you may experience issues that prevent your application from loading in the Presentation Tool preview frame. Vercel's Protection Bypass is the solution, but to make the setup process easier you can use the @sanity/vercel-protection-bypass plugin as part of your studio's configuration.

In your studio directory, add the package.

npm install @sanity/vercel-protection-bypass

pnpm add @sanity/vercel-protection-bypass

yarn add @sanity/vercel-protection-bypass

bun add @sanity/vercel-protection-bypass

Import and add the plugin to the plugins array. This adds the new tool to your studio.

import {defineConfig} from 'sanity'
import {presentationTool} from 'sanity/presentation'
import {vercelProtectionBypassTool} from '@sanity/vercel-protection-bypass'

export default defineConfig({
  //... rest of config
  plugins: [
    presentationTool({
      // ... presentation config
    }),
    vercelProtectionBypassTool()
  ]
})

Run your studio and navigate to the new "Vercel Bypass Protection" tab. Depending on where the plugin is within the plugins array, it may be in a different location in the top toolbar.

Once the steps are complete and you've added the secret, you're all set. If you need to remove or change the secret in the future, you can return to this page.

• Setting a bypass secret in your dataset enables protection bypass automation for all instances of presentationTool on sanity@3.70.0 or later. You cannot enable it for only some instances.
• You can't have different secrets for different URLs when using @sanity/vercel-protection-bypass. They must all use the same secret. If different secrets are required then this won't work for your needs.