In this guide you'll find common reasons you may be seeing a 404 error while building your GitHub Pages site.
- GitHub's Status page
- DNS setup
- Browser cache
- Directory contents
- Custom domain
If you see a 404 error while building a GitHub Pages site, first check GitHub's Status page for any active incidents.
If your GitHub Pages site is private and you see a 404 error, you may need to clear your browser's cache. For more information on clearing your cache, see your browser's documentation.
GitHub Pages will look for an
index.html file as the entry file for your site.
Make sure you have an
index.htmlfile in the repository for your site on GitHub Enterprise Server. For more information, see "Creating a GitHub Pages site."
The entry file must be at the top level of your chosen publishing source. For example, if your publishing source is the
/docsdirectory on the
mainbranch, your entry file must be located in the
/docsdirectory on a branch called
The name of the
index.htmlfile is case sensitive. For example,
Index.htmlwill not work.
The name of the file should be
index.HTMLor any other variation.
Check that your directory contents are in the root directory.
Check whether your repository meets the following requirements.
- The branch you are using to publish your site must be the
mainor default branch.
- The repository must have a commit pushed to it by someone with admin permissions for the repository, such as the repository owner.
- Switching the repository's visibility from public to private or vice versa will change the URL of your GitHub Pages site, which will result in broken links until the site is rebuilt.
If you are still receiving a 404 error, start a GitHub Community discussion in the Pages category.