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. For more information, see "GitHub's products."
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
masterbranch for a User/Organization Pages site, or to the
gh-pagesbranch for a Project Pages site.
- Create a HTML file named
404.htmlor create a new Markdown file named
404.mdat the root level of your GitHub Pages repository.
- In the YAML front matter of your new 404 file, add
- 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 GitHub.