vercel-logotype Logovercel-logotype Logo
← Back to Guides

How to Deploy a Jekyll Site with Vercel

Create a Jekyll website and deploy it live with Vercel.
Last updated on August 18, 2023
Build, Deployment & Git

This guide will show you how to deploy a Jekyll site and get your domain set up.

Jekyll is a blog-aware, static site generator perfect for personal, project, or organization sites. To build an Jekyll site, start with a template:

Vercel is a platform for deploying the fastest Jekyll sites. You can deploy your site with zero configuration to the best frontend infrastructure.

  • Develop: Build Jekyll sites that connect to your favorite APIs, databases, and content management systems.
  • Preview: Integrate with any GitHub, GitLab, or Bitbucket repository for instant continuous deployment.
  • Ship: Deploy your site to every edge node worldwide for the fastest Jekyll sites. Static files, Serverless and Edge Functions, and more.

Vercel has integrations for GitHub, GitLab, and Bitbucket to enable CI/CD for your Jekyll site with zero configuration. Then, you can run automated tests for performance and reliability on every push. Pull and merge requests are deployed instantly to a unique URL, accessible to your entire team.

After deploying, your new Jekyll site will get automatically assigned a .vercel.app suffixed domain. You can then add a Custom Domain on your choice, either from a third-party or purchased through Vercel.

  1. Install the Vercel CLI and run vercel to deploy.
  2. Vercel will detect that you are using Jekyll and will enable the correct settings for your deployment.
  3. Your site is deployed! (e.g. jekyll-template.vercel.app)
  1. Push your code to your git repository (GitHub, GitLab, BitBucket).
  2. Import your Jekyll project into Vercel.
  3. Vercel will detect that you are using Jekyll and will enable the correct settings for your deployment.
  4. Your site is deployed! (e.g. jekyll-template.vercel.app)

Please note that recent Bundler versions (2.2.3+) started changing the way of deciding the installing platform (more details in this GitHub issue). Therefore, please run the following command locally in your project repository once, and commit the resulting Gemfile.lock file to be able to deploy your project on Vercel:

bundle lock --add-platform x86_64-linux

This is important especially if you're developing your app on different platforms (e.g., macOS, Windows, etc) as Vercel's build environment uses Linux.

Couldn't find the guide you need?