New Launch

Take a deep dive into the fastest Gatsby, yet: Gatsby 5!

Deploying to Vercel

This guide walks through how to deploy and host your next Gatsby project to Vercel.

Vercel is a cloud platform that enables developers to host Jamstack websites and web services that deploy instantly, scale automatically, and requires no supervision, all with zero configuration. They provide a global edge network, SSL encryption, asset compression, cache invalidation, and more.

Step 1: Deploying your Gatsby project to Vercel

To deploy your Gatsby project with a Vercel for Git Integration, make sure it has been pushed to a Git repository.

Import the project into Vercel using the Import Flow. During the import, you will find all relevant options preconfigured for you with the ability to change as needed.

After your project has been imported, all subsequent pushes to branches will generate Preview Deployments, and all changes made to the Production Branch (commonly “master” or “main”) will result in a Production Deployment.

Once deployed, you will get a URL to see your app live, such as the following:

Step 2 (optional): Using a Custom Domain

If you want to use a Custom Domain with your Vercel deployment, you can Add or Transfer in your domain via your Vercel account Domain settings.

To add your domain to your project, navigate to your Project from the Vercel Dashboard. Once you have selected your project, click on the “Settings” tab, then select the Domains menu item. From your projects Domain page, enter the domain you wish to add to your project.

Once the domain as been added, you will be presented with different methods for configuring it.

Deploying a fresh Gatsby project

You can deploy a fresh Gatsby project, with a Git repository set up for you, with the following Deploy Button:

Deploy with Vercel


Edit this page on GitHub
© 2022 Gatsby, Inc.