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

Directory Output

Contents

Group and sort Eleventy’s verbose output by directory (and show file size with benchmarks). View the source code on GitHub.

Installation

npm install @11ty/eleventy-plugin-directory-output

Open up your Eleventy config file (probably eleventy.config.js) and use addPlugin:

eleventy.config.js
import dirOutputPlugin from "@11ty/eleventy-plugin-directory-output";

export default function (eleventyConfig) {
eleventyConfig.setQuietMode(true);
eleventyConfig.addPlugin(dirOutputPlugin);
};
const dirOutputPlugin = require("@11ty/eleventy-plugin-directory-output");

module.exports = function (eleventyConfig) {
eleventyConfig.setQuietMode(true);
eleventyConfig.addPlugin(dirOutputPlugin);
};
INFO:
You’re only allowed one module.exports in your configuration file, so make sure you only copy the require and the addPlugin lines above!

Read more about Eleventy plugins.

Options

eleventy.config.js
import dirOutputPlugin from "@11ty/eleventy-plugin-directory-output";

export default function (eleventyConfig) {
eleventyConfig.setQuietMode(true);
eleventyConfig.addPlugin(dirOutputPlugin, {
// Customize columns
columns: {
filesize: true, // Use `false` to disable
benchmark: true, // Use `false` to disable
},

// Will show in yellow if greater than this number of bytes
warningFileSize: 400 * 1000,
});
};
const dirOutputPlugin = require("@11ty/eleventy-plugin-directory-output");

module.exports = function (eleventyConfig) {
eleventyConfig.setQuietMode(true);
eleventyConfig.addPlugin(dirOutputPlugin, {
// Customize columns
columns: {
filesize: true, // Use `false` to disable
benchmark: true, // Use `false` to disable
},

// Will show in yellow if greater than this number of bytes
warningFileSize: 400 * 1000,
});
};
INFO:
The benchmark column is only compatible with Eleventy 1.0.1 or newer.

Sample Output

> eleventy-base-blog@6.0.0 build
> eleventy

↘ _site/ -- -- --
→ about/index.html about/index.md 1.8kB 2.7ms
↘ feed/ -- -- --
• .htaccess feed/htaccess.njk 0.1kB 0.2ms
• feed.json feed/json.njk 106.8kB 17.3ms
• feed.xml feed/feed.njk 109.8kB 9.8ms
→ page-list/index.html page-list.njk 3.2kB 1.1ms
↘ posts/ -- -- --
→ firstpost/index.html posts/firstpost.md 3.5kB 1.0ms
→ fourthpost/index.html posts/fourthpost.md 101.0kB 27.2ms
→ secondpost/index.html posts/secondpost.md 3.2kB 5.6ms
→ thirdpost/index.html posts/thirdpost.md 4.5kB 7.5ms
• index.html archive.njk 3.0kB 13.7ms
↘ tags/ -- -- --
→ another-tag/index.html tags.njk 2.1kB 0.9ms
→ number-2/index.html tags.njk 2.1kB 0.4ms
→ posts-with-two-tags/index.html tags.njk 2.3kB 0.2ms
→ second-tag/index.html tags.njk 2.5kB 0.5ms
• index.html tags-list.njk 2.0kB 0.4ms
404.html 404.md 1.9kB 0.4ms
• index.html index.njk 2.8kB 1.7ms
• sitemap.xml sitemap.xml.njk 1.4kB 1.3ms
[11ty] Copied 3 files / Wrote 18 files in 0.16 seconds (8.9ms each, v1.0.1)

Other pages in Official Plugins: