Error AtlasError Documentation and Resolution
Back to search

GitHub Pages

GitHub Pages failed with a Jekyll config file error

Config file error

GitHub Pages could not build the Jekyll site because the `_config.yml` file contains invalid syntax or unsupported formatting.

Config file errorconfiguration

Observed message

Config file error

Why it happens

  • The `_config.yml` file contains YAML syntax errors.
  • Tabs, malformed key-value pairs, or unquoted special characters are breaking parsing.
  • The config file contains invalid encoding or unsupported formatting.

How to fix it

  1. Validate the `_config.yml` file and correct any YAML syntax problems.
  2. Use spaces instead of tabs and add a space after each colon in key-value pairs.
  3. Quote special characters and confirm the file is UTF-8 encoded.

Official reference

GitHub Docs: Troubleshooting Jekyll build errors for GitHub Pages sites

Related errors

Missing docs folderGitHub Pages build failed because the docs folder is missingInvalid 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 config file error: causes and fixes | Error Atlas