GitHub Pages documentation

Learn how to create a website directly from a repository on your GitHub Enterprise Server instance. Explore website building tools like Jekyll and troubleshoot issues with your GitHub Pages site.

Quickstart Overview

Start here

Configuring a publishing source for your GitHub Pages site
You can configure your GitHub Pages site to publish when changes are pushed to a specific branch, or you can write a GitHub Actions workflow to publish your site.
Creating a GitHub Pages site
You can create a GitHub Pages site in a new or existing repository.
Creating a GitHub Pages site with Jekyll
You can use Jekyll to create a GitHub Pages site in a new or existing repository.
Adding content to your GitHub Pages site using Jekyll
You can add a new page or post to your Jekyll site on GitHub Pages.

About GitHub Pages and Jekyll
Jekyll is a static site generator with built-in support for GitHub Pages.
Unpublishing a GitHub Pages site
You can unpublish your GitHub Pages site so that your current deployment is removed and the site is no longer available. This is different from deleting the site.
Testing your GitHub Pages site locally with Jekyll
You can build your GitHub Pages site locally to preview and test changes to your site.
Adding a theme to your GitHub Pages site using Jekyll
You can personalize your Jekyll site by adding and customizing a theme.

What's new

View all

GitHub Pages: Deprecating symlinks in non-Actions buildsFebruary 21
GitHub Pages: Deprecating the theme pickerAugust 23
GitHub Pages: Builds with GitHub Actions GAAugust 10

Guides

Creating a custom 404 page for your GitHub Pages site
You can display a custom 404 error page when people try to access nonexistent pages on your site.
@GitHub
Adding a theme to your GitHub Pages site using Jekyll
You can personalize your Jekyll site by adding and customizing a theme.
@GitHub
Troubleshooting Jekyll build errors for GitHub Pages sites
You can use Jekyll build error messages to troubleshoot problems with your GitHub Pages site.
@GitHub

All GitHub Pages docs

Getting started with GitHub Pages

About GitHub Pages
Creating a GitHub Pages site
Using custom workflows with GitHub Pages
Configuring a publishing source for your GitHub Pages site
Deleting a GitHub Pages site
Unpublishing a GitHub Pages site
Creating a custom 404 page for your GitHub Pages site
Troubleshooting 404 errors for GitHub Pages sites

Setting up a GitHub Pages site with Jekyll

About GitHub Pages and Jekyll
Creating a GitHub Pages site with Jekyll
Testing your GitHub Pages site locally with Jekyll
Adding content to your GitHub Pages site using Jekyll
Setting a Markdown processor for your GitHub Pages site using Jekyll
Adding a theme to your GitHub Pages site using Jekyll
About Jekyll build errors for GitHub Pages sites
Troubleshooting Jekyll build errors for GitHub Pages sites

Start here

Configuring a publishing source for your GitHub Pages site

Creating a GitHub Pages site

Creating a GitHub Pages site with Jekyll

Adding content to your GitHub Pages site using Jekyll

Popular

About GitHub Pages and Jekyll

Unpublishing a GitHub Pages site

Testing your GitHub Pages site locally with Jekyll

Adding a theme to your GitHub Pages site using Jekyll

What's new

Guides

Creating a custom 404 page for your GitHub Pages site

Adding a theme to your GitHub Pages site using Jekyll

Troubleshooting Jekyll build errors for GitHub Pages sites

All GitHub Pages docs

Getting started with GitHub Pages

Setting up a GitHub Pages site with Jekyll