Content collections with YAML frontmatter and Markdown for the Roots static site generator
CoffeeScript CSS HTML
Latest commit 7cfbfa4 Mar 18, 2016 @biilmann biilmann Fix roots 4 compatibility
Failed to load latest commit information.
lib Fix roots 4 compatibility Mar 19, 2016
testsite Added a test site Jan 9, 2016
.gitignore First Commit May 5, 2015
LICENSE First Commit May 5, 2015 Fix #5 - typo in READMe Jan 9, 2016
package.json Fix roots 4 compatibility Mar 19, 2016

Roots Collections

Content Collections based on Markdown with Frontmatter for the Roots static site generator.


  • make sure you're in your roots project directory
  • npm install roots-collections --save
  • modify your file to include the extension

    collections = require 'roots-collections'
    module.exports =
     extensions: [collections(folder: 'posts', layout: 'post')]


Once you've installed the extension, Roots will search the specified folder for collections and make them available in your templates.

Files in the folder should end with the extension .md and be written as markdown with YAML frontmatter:

title: This is the title
desc: A description

# I am markdown


If the file names follow the following patter:


The extension will automatically add a date to the entries based on the date in the filename.

If a layout is specified, each entry will be rendered with the specified layout. The layout template can access an entry variable with the title, date, slug, body, and other metadata from the entry.

extends layout

block content entry.title
  .post-body!= entry.body

Entry Listings

The name of the collection is based on the folder, unless you explicitly set a name when configuring the extension.

So if you configure the extension with posts(folder: 'posts') you will be able to use posts.orderBy('date','desc') in templates. If you configure the extension with posts(folder: 'docs'), you'll be able to use docs.orderBy('title') in templates.


  each post in posts.orderBy('date', 'desc').slice(0, 10)
    h3.title post.title
    .body!= post.body

Computed Entry Properties

By default the collections extension will compute the slug, permalink,date and body properties based on the filename of each entry, but you can also hook into the compilation phase to add your own computed properties or modify any of the default properties, by passing a prepare function to the extension:

Here's a simple example of adding an upcased_title property to each entry.

module.exports =
  extensions: [collections(
    folder: 'posts',
    layout: 'post',
    prepare: (post) ->
      post.upcased_title = post.title && post.title.toUpperCase()


This extension is published under the MIT License