Skip to navigation Skip to main content
Eleventy
Eleventy Documentation
Stable
3.0.0
Toggle Menu
Eleventy 5.81s
Gatsby 43.36s

Preprocessors Added in v3.0.0

Contents

The Preprocessor Configuration API allows you to intercept and modify the content in template files (not Layouts) before they’re processed and rendered by Eleventy.

eleventy.config.js
export default function (eleventyConfig) {
eleventyConfig.addPreprocessor("drafts", "njk,md,liquid", (data, content) => {
if(data.draft) {
// Ignore this file.
return false;
}

// You can also modify the raw input of the template here too, be careful!
return `${content}<!-- Template file: {{ page.inputPath }} -->`;

// If you return nothing or `undefined`, no changes will be made to this template.
});
};
module.exports = function (eleventyConfig) {
eleventyConfig.addPreprocessor("drafts", "njk,md,liquid", (data, content) => {
if(data.draft) {
// Ignore this file.
return false;
}

// You can also modify the raw input of the template here too, be careful!
return `${content}<!-- Template file: {{ page.inputPath }} -->`;

// If you return nothing or `undefined`, no changes will be made to this template.
});
};
  • The first argument is an arbitrary name (String) used for error messaging.
  • The second argument can be:
    • a String of comma separated file extensions
    • an Array<String> of file extensions
  • Returning false will ignores the template in the same way as using eleventyConfig.ignores or .eleventyignore
  • Returning nothing or undefined has no effect (unlike Transforms)

Originally GitHub Issue #188.

Example: Drafts

Here’s an example that uses the Preprocessor API to implement a Drafts workflow.

Set draft: true anywhere in a file’s data cascade and that file will be only be built when using Eleventy in --serve or --watch modes. It will be excluded from full Eleventy builds.

You might imagine how this could be extended to add a publishing date feature too: to exclude content from builds before a specific date set in a post’s front matter (or elsewhere in the data cascade).

eleventy.config.js
export default function (eleventyConfig) {
eleventyConfig.addPreprocessor("drafts", "*", (data, content) => {
if(data.draft && process.env.ELEVENTY_RUN_MODE === "build") {
return false;
}
});
};
module.exports = function (eleventyConfig) {
eleventyConfig.addPreprocessor("drafts", "*", (data, content) => {
if(data.draft && process.env.ELEVENTY_RUN_MODE === "build") {
return false;
}
});
};

Other pages in Configuration: