Error AtlasError Documentation and Resolution
Back to search

GitHub Pages

GitHub Pages failed because of a Liquid for-loop syntax error

Syntax error in 'for' loop

GitHub Pages could not build the site because a Liquid for-loop expression is malformed or uses unsupported syntax.

Syntax error in 'for' loopbuild

Observed message

Syntax error in 'for' loop

Why it happens

  • A Liquid for-loop uses invalid syntax.
  • Loop variables, ranges, or delimiters are malformed.
  • Template edits introduced a syntax error into a layout, include, or content file.

How to fix it

  1. Review the reported Liquid for-loop and compare it to valid Jekyll Liquid syntax.
  2. Check nearby braces, tags, and loop delimiters for malformed expressions.
  3. Test the site locally so the exact failing template line is easier to isolate.

Official reference

GitHub Docs: Troubleshooting Jekyll build errors for GitHub Pages sites

Related errors

Tag not properly closedGitHub Pages failed because a tag was not properly closedTag not properly terminatedGitHub Pages failed because a tag was not properly terminatedMarkdown errorsGitHub Pages failed because of Markdown errorsMissing docs folderGitHub Pages build failed because the docs folder is missing

Explore more

buildBrowse more build errors
GitHub Pages syntax error in for loop: causes and fixes | Error Atlas