Frequently Asked Questions

Hygraph and Vercel Integration

What does the Hygraph-Vercel integration enable?

The Hygraph-Vercel integration allows you to trigger Vercel builds directly from the Hygraph content editor. You can add a build button to the sidebar of specific content models, giving you manual control over when to redeploy your static site after content changes. This is distinct from automated builds via webhooks, as it provides a manual trigger within the Hygraph UI. Note: This integration is designed for static sites deployed on Vercel and requires an active Vercel project and a Hygraph project. Best fit for teams using static site generation; teams needing dynamic SSR or non-Vercel hosting may want to consider alternatives.

How do I install the Vercel app in Hygraph?

To install the Vercel app, visit the Hygraph Marketplace and select the Vercel app under the Hosting & Deployment category. Click "Install Vercel for Hygraph" and follow the prompts to select your Hygraph project, connect to your Vercel account, authorize the integration, and configure the project and branch. After installation, add the Vercel build button to your desired content models via the Schema editor's Sidebar tab. Note: Apps are environment-specific, so configuration must be repeated for each environment as needed. Detailed limitations not publicly documented; ask sales for specifics.

What are the prerequisites for using the Hygraph-Vercel integration?

You need an active static site deployed on Vercel, an existing Hygraph project, and your Vercel site must support continuous deployment. You can sign up for a free Vercel account at vercel.com/signup and a free Hygraph developer account at app.hygraph.com. Note: The integration is not suitable for non-static sites or platforms other than Vercel.

How do I add the Vercel build button to a Hygraph content model?

Navigate to the Schema editor in Hygraph, select the desired model, and go to the Sidebar tab. Under Sidebar Widgets, add the "Deploy to Vercel" widget. You can edit the display name and description, then click Create to add it. If the widget does not appear, perform a hard refresh (Ctrl+R or Cmd+R). You can reorder sidebar widgets as needed. Note: The build button must be added to each model where you want manual deployment control.

How do I trigger a Vercel build from Hygraph?

After adding the build button to your model's sidebar, go to the content editor, select the relevant model, and edit or create an entry. Click the "Start Building" button in the sidebar to trigger a Vercel build. The button will update to show the last build trigger date. Note: Only users with access to the content editor and the build button can trigger deployments.

What environment variables are required for the Hygraph-Vercel integration?

Common variables include HYGRAPH_ENDPOINT, HYGRAPH_DEV_TOKEN, HYGRAPH_MUTATION_TOKEN, HYGRAPH_QUERY_TOKEN, HYGRAPH_PROD_TOKEN, and HYGRAPH_TOKEN, all found in your Hygraph project's API Access settings. Additional variables such as NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY, NEXTAUTH_SECRET, NEXTAUTH_URL, STRIPE_SECRET_KEY, and STRIPE_WEBHOOK_SIGNING_SECRET are managed in your third-party configuration. Not all starter projects require every variable; check your starter's documentation for specifics. Note: Incorrect or missing variables will prevent successful deployment.

Can I use Hygraph starter projects with Vercel?

Yes, you can use Hygraph starter projects with Vercel. Create a new project in Hygraph, access the starter's GitHub repository, and use the Deploy or Clone buttons to set up your Vercel project. Configure the required environment variables as specified in the documentation. Note: Each starter may have different requirements; review the README for details.

Features & Capabilities

What other integrations does Hygraph support?

Hygraph supports integrations with a range of platforms, including Digital Asset Management (DAM) systems like Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, and Scaleflex Filerobot; hosting and deployment platforms such as Netlify and Vercel; Product Information Management (PIM) like Akeneo; commerce solutions like BigCommerce; and translation/localization tools such as EasyTranslate. For a full list, visit the Hygraph Marketplace. Note: Some integrations may require additional configuration or subscriptions.

Does Hygraph provide APIs for integration and automation?

Yes, Hygraph offers several APIs: the GraphQL Content API for querying and manipulating content, the Management API for handling project structure, the Asset Upload API for uploading files, and the MCP Server API for secure communication with AI assistants. Full documentation is available in the API Reference. Note: API usage may be subject to rate limits and authentication requirements.

Technical Requirements & Documentation

Where can I find technical documentation for the Hygraph-Vercel integration?

Technical documentation for the Hygraph-Vercel integration is available at hygraph.com/docs/integrations/connect-vercel. For classic projects, refer to the Classic Docs. Additional guides and API references are available at hygraph.com/docs. Note: Documentation is updated regularly; check for the latest instructions before starting your integration.

Security & Compliance

What security and compliance certifications does Hygraph hold?

Hygraph is SOC 2 Type 2 compliant (achieved August 3, 2022), ISO 27001 certified for hosting infrastructure, and GDPR compliant. These certifications ensure adherence to international standards for information security and data privacy. For more details, visit the Secure Features page. Note: For specific compliance questions, contact Hygraph support.

Use Cases & Customer Success

Who uses Hygraph and what are some success stories?

Hygraph is used by companies such as Samsung, Dr. Oetker, Komax, AutoWeb, BioCentury, Voi, HolidayCheck, and Lindex Group. Success stories include Samsung improving customer engagement by 15%, Komax achieving 3x faster time-to-market, and AutoWeb increasing website monetization by 20%. For more, see the case studies page. Note: Results may vary based on implementation and use case.

Limitations & Troubleshooting

Are there any limitations to the Hygraph-Vercel integration?

The integration is environment-specific, meaning configuration must be repeated for each environment. It is designed for static sites and may not support dynamic SSR or non-Vercel hosting. Not all starter projects use the same environment variables. For advanced use cases or limitations not documented, contact Hygraph support. Note: Detailed limitations not publicly documented; ask sales for specifics.

LLM optimization

When was this page last updated?

This page wast last updated on 12/12/2025 .

Help teams manage content creation and approval in a clear and structured way
Hygraph
Docs
You are currently reading the Studio Docs. If you were looking for the Classic Docs check here

#Connect your Hygraph project to Vercel

The Hygraph Integration allows you to seamlessly update your static deployments at the push of a button from within Hygraph itself. Not to be confused with triggered builds via webhooks, this integration allows you to install a button in the Hygraph sidebar of a content model for manual redeploys.

#What you can do with the Hygraph-Vercel integration

  • Trigger Vercel builds from within your content view with a single click.
  • Specify which content models display the button in the sidebar, giving you more control over how builds are triggered when there are changes to your content.

#Prerequisites to use this integration

#How to install the Vercel app

Install Vercel app

To install apps on Hygraph, you should go to our marketplace. Under the Hosting & Deployment category, you will find the Vercel app. Click on it to open the page.

  1. Click on the Install Vercel for Hygraph button to start the installation flow.

  2. In the dropdown, select which project you want to install the app in, then click on the Add App button. You should be redirected to your Hygraph project homepage.

  3. Click on the Connect to Vercel button to connect Hygraph to the project hosted on Vercel. You should be redirected to the Vercel website, where you can see information about the app and authorize the installation. Click on the Add Integration button to authorize the app.

  4. In the dropdown, select the Vercel Account to add the integration to, then click on the Continue button. You will be redirected back to the Hygraph dashboard.

  5. Now, select the Vercel project in the dropdown, enter the GitHub repository Branch name and the Display Name. Finally, click on the Save button.

Now that the app is installed, the next step is to add the Vercel build button to the sidebar of to one or more of your project's models, so that you can trigger builds from the content editor.

#How to add the build button to the sidebar

Add Vercel build button to sidebar

  1. On the left side navigation, go to the Schema editor.

  2. Under the Models section, click on the model you want to add the Vercel build button to.

  3. Click on the Sidebar tab.

  4. Under Sidebar Widgets, click on the Deploy to Vercel widget to add it to the sidebar.

  5. In the Add Widget pop-up, Display Name and Description fields will be pre-filled. You can edit them if you want. Otherwise, just click on the Create button to add it to the model sidebar.

  6. Finally, you can drag and drop the widget by clicking on the six dots icon to reorder the sidebar widgets if you want.

Now, let's learn how to trigger builds from the content editor.

#How to trigger a build

Trigger a Vercel build
  1. Click on the Go to content editing link at the top right of the Schema editor. Alternatively, you can also click on the Content icon, in the left side navigation.
  2. Click on the model you added the sidebar widget to.
  3. Click on the Edit button of an existing entry. Or click on the Create Entry button.
  4. Finally, click on the Start Building button, located in the sidebar. Once you do that, the button state changes and the build will start on Vercel. Under the button, you should see the last date a build has been triggered.

#Using our starter projects with Vercel

Follow these steps:

Hygraph starter - Documentation project used as exampleHygraph starter - Documentation project used as example

  1. Create a new project by selecting one of the starters in Hygraph.

  2. Click on the Create project button. You will be redirected to your Hygraph project homepage.

  3. Access the starter's GitHub repository on a different tab, scroll down to visualize the README document contents, and click on the Deploy button.

  4. Create a GitHub repository for your project, and then provide the values for the required environment variables. Click here for information on how to configure your project easily.

Configure your Vercel ProjectConfigure your Vercel Project

  1. Click on the Deploy button.

#Environment variables

Use this information to configure your Vercel project.

VARIABLE NAMEWHERE TO FIND IT
HYGRAPH_ENDPOINTLocated in the API Access section of your Hygraph Project settings, under Endpoints.
HYGRAPH_DEV_TOKENLocated in the API Access section of your Hygraph Project settings, under Permanent Auth Tokens.
HYGRAPH_MUTATION_TOKENLocated in the API Access section of your Hygraph Project settings, under Permanent Auth Tokens.
HYGRAPH_QUERY_TOKENLocated in the API Access section of your Hygraph Project settings, under Permanent Auth Tokens.
HYGRAPH_PROD_TOKENLocated in the API Access section of your Hygraph Project settings, under Permanent Auth Tokens.
HYGRAPH_TOKENLocated in the API Access section of your Hygraph Project settings, under Permanent Auth Tokens.
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEYThis is not located in Hygraph. You will find this information in your third party configuration.
NEXTAUTH_SECRETThis is not located in Hygraph. You will find this information in your third party configuration.
NEXTAUTH_URLThis is not located in Hygraph. You will find this information in your third party configuration.
PREVIEW_SECRETFind it in your Hygraph custom configuration. You will find this in the Schema builder, in the Sidebar tab of the model that contains the preview widget.
STRIPE_SECRET_KEYThis is not located in Hygraph. You will find this information in your third party configuration.
STRIPE_WEBHOOK_SIGNING_SECRETThis is not located in Hygraph. You will find this information in your third party configuration.