Documentation Pages
Nunjucks
Template Languages:
Eleventy Short Name | File Extension | NPM Package |
---|---|---|
njk |
.njk |
nunjucks |
You can override a .njk
file’s template engine. Read more at Changing a Template’s Rendering Engine.
Use your Nunjucks Environment #
New in Eleventy v0.3.0
: As an escape mechanism for advanced usage, pass in your own instance of a Nunjucks Environment using the Configuration API.
module.exports = function(eleventyConfig) { let Nunjucks = require("nunjucks"); let nunjucksEnvironment = new Nunjucks.Environment( new Nunjucks.FileSystemLoader("_includes") ); eleventyConfig.setLibrary("njk", nunjucksEnvironment);};
Supported Features #
Feature | Syntax |
---|---|
✅ Includes | {% include 'included.njk' %} looks in _includes/included.njk |
✅ Extends | {% extends 'base.njk' %} looks in _includes/base.njk |
✅ Imports | {% import 'macros.njk' %} looks in _includes/macros.njk |
✅ Filters | {% name | filterName %} Read more about Filters. |
✅ Eleventy Universal Filters | {% name | filterName %} Read more about Filters. |