VOOZH about

URL: https://docs.github.com/enterprise/2.10/user/articles/page-build-failed-file-does-not-exist-in-includes-directory

⇱ Page build failed: File does not exist in includes directory - GitHub Enterprise 2.10 Documentation

GitHub Help

This version of GitHub Enterprise was discontinued on June 5, 2018. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Customizing GitHub Pages / Page build failed: File does not exist in includes directory

Page build failed: File does not exist in includes directory

If your GitHub Pages code references a file that doesn't exist in your _includes directory, your GitHub Pages site will not build.

If you reference a file that doesn't exist in your _includes directory, you'll get an email that looks like this:

Subject: Page build failed

The page build failed with the following error:

A file was included in `example.html` that does not exist in your `_includes` directory

You will only receive an email if outbound email support is enabled on your Enterprise instance. For more information, contact your site administrator.

Troubleshooting a nonexistent file error

Tip: We strongly recommend running Jekyll locally so you can easily debug and fix build errors before pushing to your GitHub Enterprise instance. To learn more about troubleshooting options, see "Troubleshooting GitHub Pages builds."

  1. Use your favorite text editor to open the file mentioned in the build failure email.
  2. Search for the include tag to see where you've referenced other files. For example: {% include example_header.html %}.
  3. If you've referenced any files that aren't in the _includes directory of your GitHub Pages repository, you will need to copy or move them into the _includes directory. If the files don't exist at all, you will need to create them.
  4. Commit the changes and push them to your GitHub Pages repository to trigger another build on the server.

Article versions

👁 The GitHub Logo

© 2018 GitHub Inc. All rights reserved.