The Data Cascade

Contents

Sources of Data
Community Resources
Example

In Eleventy, data is merged from multiple different sources before the template is rendered. The data is merged in what Eleventy calls the Data Cascade.

Sources of Data Jump to heading

When the data is merged in the Eleventy Data Cascade, the order of priority for sources of data is (from highest priority to lowest):

Community Resources Jump to heading

I Finally Understand Eleventy’s Data Cascade

Screenshot of https://benmyers.dev/blog/eleventy-data-cascade/

+ Add yours!

Example Jump to heading

Filename my-template.md

---
title: This is a Good Blog Post
tags:
  - CSS
  - HTML
layout: my-layout.njk
---

Filename _includes/my-layout.njk

---
title: This is a Very Good Blog Post
author: Zach
tags:
  - JavaScript
---

Note that when my-template.md and my-layout.njk share data with the same object key (title and tags), the “leaf template” my-template.md takes precedence.

The data cascade results in the following data when my-template.md is rendered:

Syntax JavaScript

{
  "title": "This is a Good Blog Post",
  "author": "Zach",
  "tags": [
    "CSS",
    "HTML",
    "JavaScript"
  ],
  "layout": "my-layout.njk"
}

By default in v1.0, Eleventy does a deep data merge to combine Object literals and Arrays. If you want to opt-out of this behavior and revert to a simple top level merge (Object.assign) from the different data sources, you can turn off Data Deep Merge. You can override this on a per-property basis too—read more at the Data Deep Merge documentation.

The Data Cascade

Sources of Data Jump to heading #

Community Resources Jump to heading #

Example Jump to heading #

Other pages in Using Data:

Sources of Data Jump to heading

Community Resources Jump to heading

Example Jump to heading