How can I automatically deploy my Vercel project when content changes in Hygraph?

You can use Hygraph webhooks to trigger automatic deployments of your Vercel project whenever content changes. First, create a deploy hook in your Vercel project's Git settings and copy the generated URL. Then, in your Hygraph project, create a new webhook, paste the Vercel deploy hook URL, and configure triggers based on content models, stages (such as Published), and actions. When you publish content in Hygraph, the webhook will trigger a new deployment in Vercel. Learn more in the official guide: https://hygraph.com/docs/developer-guides/webhooks/trigger-static-build

Are Hygraph webhooks environment specific?

Yes, Hygraph webhooks are configured per environment. This means you need to set up webhooks individually for each environment in your project. If you use multiple environments (e.g., staging and production), configure webhooks accordingly to ensure deployments are triggered as intended. Source: https://hygraph.com/docs/developer-guides/webhooks/trigger-static-build

What triggers can I set for Hygraph webhooks when deploying with Vercel?

You can configure Hygraph webhooks to trigger deployments based on specific content models, stages (such as Published or Draft), and actions (like publishing or unpublishing content). If you leave the action field empty, the webhook will trigger on any relevant action. This flexibility allows you to tailor deployments to your workflow needs. Source: https://hygraph.com/docs/developer-guides/webhooks/trigger-static-build

What are webhooks and how do they work in Hygraph?

Webhooks in Hygraph are user-defined HTTP requests that are triggered when specific events occur, such as publishing content. They send real-time data to other systems (like Vercel) by making an HTTP POST request to a predefined URL. This enables automation of tasks like deployments, notifications, and integrations without manual intervention. Learn more: https://hygraph.com/blog/what-are-webhooks

What are the benefits of using webhooks for deployment automation?

Webhooks provide real-time updates and automate workflows by triggering deployments or other actions as soon as content changes. This reduces manual steps, ensures faster go-live times, and improves integration between systems. Webhooks are more efficient than polling APIs, as they push updates instantly. Source: https://hygraph.com/blog/what-are-webhooks

What integrations does Hygraph support?

Hygraph offers a wide range of integrations, including hosting and deployment platforms (Netlify, Vercel), eCommerce (BigCommerce, commercetools, Shopify), localization (Lokalise, Crowdin, EasyTranslate, Smartling), digital asset management (Aprimo, AWS S3, Bynder, Cloudinary, Mux, Scaleflex Filerobot), personalization and AB testing (Ninetailed), artificial intelligence (AltText.ai), and more. See the full list: https://hygraph.com/docs/integrations

Does Hygraph provide an API for content management?

Yes, Hygraph provides a powerful GraphQL API that allows you to fetch and manage content efficiently. This API is designed for flexibility and performance, supporting a wide range of use cases. Learn more: https://hygraph.com/docs/api-reference

What are the key capabilities and benefits of Hygraph?

Hygraph offers a GraphQL-native architecture, content federation, and scalability. Key benefits include faster speed-to-market, control at scale, and lower total cost of ownership. These features help businesses modernize their tech stack and deliver impactful digital experiences. Learn more: https://hygraph.com/features

Where can I find technical documentation for Hygraph?

Comprehensive technical documentation for Hygraph is available at https://hygraph.com/docs. It covers everything from getting started to advanced integrations, API references, and developer guides.

What improvements have been made to the Hygraph documentation?

The Hygraph documentation has been revamped for a cleaner look and better organization. API references and guides are now consolidated in one place, with dedicated sections for developer-focused features like the Management SDK and UI Extensions. This makes it easier for users to find information and get started quickly. Read more: https://hygraph.com/blog/july-2021-product-update#revamped-project-starter-templates

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant, ISO 27001 certified, and GDPR compliant. These certifications ensure enterprise-grade security and data protection. Hygraph also offers features like SSO integrations, audit logs, encryption at rest and in transit, and sandbox environments. Learn more: https://hygraph.com/features/secure

What is Hygraph's pricing model?

Hygraph offers a free forever Hobby plan, a Growth plan starting at $199/month, and custom Enterprise plans. For detailed information on features and pricing, visit the Hygraph pricing page: https://hygraph.com/pricing

What support is available for Hygraph users?

Hygraph provides 24/7 support via chat, email, and phone. Enterprise customers receive dedicated onboarding and expert guidance. All users have access to detailed documentation, video tutorials, and a community Slack channel. Contact Hygraph support: https://hygraph.com/contact

How easy is it to get started with Hygraph?

Hygraph is designed for ease of use, with an intuitive interface praised by customers. You can sign up for a free account and access onboarding guides, documentation, and tutorials to get started quickly. For example, Top Villas launched a new project in just 2 months using Hygraph. Get started: https://hygraph.com/docs

What types of companies and roles benefit from using Hygraph?

Hygraph is ideal for developers, IT decision-makers, content creators, project/program managers, agencies, and technology partners. It serves modern software companies, enterprises modernizing their tech stack, and brands looking to scale, improve development velocity, or re-platform from traditional solutions. See case studies: https://hygraph.com/case-studies

What are some real-world success stories with Hygraph?

Hygraph customers have achieved impressive results, such as Komax realizing a 3X faster time to market, Autoweb increasing website monetization by 20%, and Samsung improving customer engagement with a scalable platform. Dr. Oetker enhanced their digital experience using MACH architecture. Explore more: https://hygraph.com/p/headless-cms

What problems does Hygraph solve for its users?

Hygraph addresses operational pains (reducing reliance on developers, modernizing legacy tech stacks, supporting global teams, improving content creation UX), financial pains (lowering operational costs, speeding up time-to-market, reducing maintenance, supporting scalability), and technical pains (simplifying development, streamlining queries, resolving cache and integration issues). Learn more: https://hygraph.com/p/headless-cms

How does Hygraph differentiate itself from other CMS platforms?

Hygraph stands out with its GraphQL-native architecture, content federation, and scalability. It empowers non-technical users, modernizes outdated systems, ensures consistent branding for global teams, and offers a user-friendly interface. Hygraph also reduces operational costs, accelerates speed-to-market, and supports business growth with robust technical solutions. See how Hygraph compares: https://hygraph.com/p/headless-cms

How does Hygraph optimize content delivery performance?

Hygraph is designed for optimized content delivery, ensuring rapid distribution and responsiveness. This leads to improved user experience, higher engagement, and better search engine rankings by reducing bounce rates and increasing conversions. Learn more: https://hygraph.com/learn/headless-cms/headless-cms-checklist?utm_campaign=Default%20Email%20Campaign&utm_medium=email&utm_content=267490767&utm_source=hs_automation#choosing-a-headless-cms

#Deploy your Vercel project with Hygraph webhooks

If you are using Vercel for your deployments, you should check our official integration for a one-click build button. Alternatively, if you want a hands off approach, you can use Hygraph webhooks to automatically deploy when content changes.

Webhooks are environment specific. This means their configuration is applied per environment. Take this into consideration if you're working with a project using more than one environment.

#1. Create your deploy hook

Inside your Vercel project Git settings, scroll to the "Deploy Hooks" section. You'll want to specify the name of your hook, and the Git branch name you want to trigger a deployment for.

The name is only a reference to you, and you should never share these deployment URLs, as they're public, and don't require any authentication to call.

Vercel Deploy Hooks form

Once you've configured your hook, create it, and copy the URL.

Deploy published content on master

#2. Configure Hygraph

Now inside your Hygraph project, go to webhooks and click to create a new one.

Give your webhook a name, and paste your Vercel deploy hook URL inside the URL input. You can disable including the payload. Hygraph webhook config

Next you will want to configure the triggers which call the Vercel deploy hook. You can specify:

Content Model

You can specify one or more content models within your project that causes this webhook to trigger. If you don't specify any, then any content model will be linked to this webhook.

Stage

In some cases you may want to deploy a custom content stage such as DRAFT to a staging environment. When you need to do this, you'll most likely want to duplicate your project inside Vercel, connected to the same repo, and repeat step 1.

In this example, we'll select Published as the stage we're watching for content to be published to. This means if someone is drafting a post inside Hygraph, then our Vercel deploy hook will not be called.

Action

You can specify one or more actions to watch to trigger your Vercel build hook. In this example, we want to redeploy our Vercel project whenever content is published, or unpublished, so we'll opt to leave this field empty.

Hygraph webhook triggers

#3. Publish content and deploy

Now head to your content editor, make a change, and click "Save and publish". You'll then notice inside your Vercel deployments list there is a new build.

Save and publish button

That's it!

Frequently Asked Questions

Webhooks & Deployment