Error AtlasError Documentation and Resolution
Back to search

GitHub Pages

GitHub Pages Jekyll build failed because a post has an invalid post date

Invalid post date

GitHub Pages could not build the Jekyll site because a post filename or front matter date does not meet Jekyll's post date expectations.

Invalid post datebuild errors

Observed message

Invalid post date

Why it happens

  • A post filename does not use the required Jekyll date prefix format.
  • The post front matter contains an invalid or conflicting date value.
  • The date in the filename or content cannot be parsed correctly.

How to fix it

  1. Rename the post using a valid Jekyll post date prefix such as YYYY-MM-DD-title.md.
  2. Correct any invalid `date` value in the post front matter.
  3. Ensure the filename and front matter do not conflict on date interpretation.

Official reference

GitHub Docs: Troubleshooting Jekyll build errors for GitHub Pages sites

Related errors

Date 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 directoryFile is not properly UTF-8 encodedGitHub Pages Jekyll build failed because a file is not properly UTF-8 encodedInvalid highlighter languageGitHub Pages Jekyll build failed because an invalid highlighter language was used

Explore more

build errorsBrowse more build errors errors
GitHub Pages invalid post date: causes and fixes | Error Atlas