Error AtlasError Documentation and Resolution
Back to search

GitHub Pages

GitHub Pages build failed because the docs folder is missing

Missing docs folder

GitHub Pages could not publish the site because the repository is configured to build from the `docs` folder but that folder does not exist or is not in the expected branch.

Missing docs folderconfiguration

Observed message

Missing docs folder

Why it happens

  • GitHub Pages is configured to publish from `/docs` but the folder is missing.
  • The expected docs directory is not present on the publishing branch.
  • The Pages source setting does not match the repository layout.

How to fix it

  1. Create the `docs` folder in the publishing source if that is the intended layout.
  2. Or change the GitHub Pages source to the correct branch and folder.
  3. Confirm the publishing branch contains the files GitHub Pages expects.

Official reference

GitHub Docs: Troubleshooting Jekyll build errors for GitHub Pages sites

Related errors

Config file errorGitHub Pages failed with a Jekyll config file errorInvalid YAML in data fileGitHub Pages Jekyll build failed because a data file contains invalid YAMLDate is not a valid datetimeGitHub Pages Jekyll build failed because a date is not a valid datetimeFile does not exist in includes directoryGitHub Pages Jekyll build failed because a file does not exist in the includes directory

Explore more

configurationBrowse more configuration errors
GitHub Pages missing docs folder: causes and fixes | Error Atlas