GitHub Pages now runs Jekyll 3.1
As promised, GitHub Pages has moved to the Jekyll 3.1 branch with an upgrade to Jekyll 3.1.6. Jekyll 3.1 brings significant performance improvements to GitHub Pages. By using Liquid::Drops, rather…
As promised, GitHub Pages has moved to the Jekyll 3.1 branch with an upgrade to Jekyll 3.1.6. Jekyll 3.1 brings significant performance improvements to GitHub Pages. By using Liquid::Drop
s, rather than Ruby Hash
es, Jekyll now calculates document and site metadata on demand, rather than calculating every possible value at build time.
While this should be a seamless transition for most GitHub Pages users, we recommend that all users test locally using the GitHub Pages Gem before pushing. This ensures that your site will continue to build as expected. Three things to note as you upgrade:
- All front matter defined in layouts are now accessible only via
{% raw %}{{ layout }}{% endraw %}
. In you define a variablewidth: full
in your layout’s YAML front matter, access it withlayout.width
. - The inheritance of front matter values properly merges a child layout’s front matter over its parent’s front matter. If you define a variable
color: purple
in a layout calledpost
which has a parent layout ofdefault
, and you definecolor: blue
in thedefault
layout, then{% raw %}{{ layout.color }}{% endraw %}
will bepurple
. For more on this, read the pull request that made the change. - If you are using the Jekyll Bootstrap theme, you must update the contents of
_includes/JB/setup
to use{% raw %}{{ layout.theme.name }}{% endraw %}
instead of{% raw %}{{ page.theme.name }}{% endraw %}
.
Beyond the performance improvements, Jekyll 3.1.6 includes over 100 changes, including many bug fixes, both to the rendering process and to the experience of previewing Jekyll locally.
For a full list of changes, see the Jekyll changelog and of course, if you have any questions, please get in touch with us.
Written by
Related posts

From pair to peer programmer: Our vision for agentic workflows in GitHub Copilot
AI agents in GitHub Copilot don’t just assist developers but actively solve problems through multi-step reasoning and execution. Here’s what that means.

GitHub Availability Report: May 2025
In May, we experienced three incidents that resulted in degraded performance across GitHub services.

GitHub Universe 2025: Here’s what’s in store at this year’s developer wonderland
Sharpen your skills, test out new tools, and connect with people who build like you.