Creating a custom 404 page for your GitHub Pages site
GitHub Pages is available in public repositories with GitHub Free, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.
You can display a custom 404 error page when people try to access nonexistent pages on your site.
- Navigate to your GitHub Pages repository.
- Switch to the
master
branch for a User/Organization Pages site, or to thegh-pages
branch for a Project Pages site. - Create a HTML file named
404.html
or create a new Markdown file named404.md
at the root level of your GitHub Pages repository. - In the YAML front matter of your new 404 file, add
permalink: /404.html
. - Add the content you want to display to lost souls and weary travelers.
- Commit your changes and, if you're working on a local clone of your repository, push them up to your GitHub Enterprise Server instance.