[Docs]: Liquid 4 docs hard to find / Liquid version is unclear
Author: bobbybobbyCreated Feb 28, 2026Updated Mar 28, 2026
Labelshas-pull-requestdocumentation
Motivation
The official Liquid documentation (as linked in Jekyll's doc) refers to its version 5.0. However Jekyll uses Liquid 4.0. It makes it hard to understand what is valid or not (e.g Liquid 5 says "The include tag is deprecated, use render").
Also, Jekyll doc doesn't explicitly say that it still uses Liquid 4.0, I had to look up the gemspec from the source.
Suggestion
Different suggestions :
- Update Jekyll to use Liquid 5, and updates the Jekyll docs accordingly
- Fork Liquid 4 docs and embed them into Jekyll doc
- At least, put a warning in Jekyll doc regarding the version mismatch issue
Source: jekyll/jekyll