Creating a custom 404 page for your GitHub Pages site

1. On GitHub Enterprise, navigate to your site's repository.

2. Navigate to the publishing source for your site. For more information about publishing sources, see "About GitHub Pages."

3. Above the list of files, click Create new file.

   

4. In the file name field, type 404.html or 404.md.

   

5. If you named your file 404.md, add the following YAML front matter to the beginning of the file:

   ---
   permalink: /404.html
   ---
   

6. Below the YAML front matter, if present, add the content you want to display on your 404 page.

7. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."

   

8. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. For more information, see "Creating a new pull request."

   

9. Click Propose new file.

   

Further reading

• Front matter in the Jekyll documentation