Skip to content
Templates for rendering JSON feeds for your Jekyll blog
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Jekyll JSON Feed Templates

A few Liquid templates to use for rendering JSON feeds for your Jekyll blog in keeping with the JSONFeed spec. Like it's sister project jekyll-rss-feeds, it features a number of kinds of feeds:

  • feed.json — Renders the 10 most recent posts.
  • feed.category.json — Only renders posts for a specific category. This example renders posts for a "miscellaneous" category.
  • feed.tag.json — Only renders posts for a specific tag. This example renders posts for a "jekyll" category.
  • feed.links.json — Only contains posts that link to external websites noted by a link variable in the YAML Front Matter. Not a common Jekyll convention, but a good way to generating a linked list.
  • feed.articles.json — Only showing articles that don't link to external sites; The opposite of feed.links.json

How to use

  • Update _config.yml as noted below, or manually replace the variables.
  • Copy one of the JSON (ie, feed.json) files to the root directory of your Jekyll blog.
  • Run jekyll.

In your generated _site folder you should find a properly formatted feed at feed.json.

Customizing _config.yml

These templates rely on a customized version of _config.yml. The following lines have been added:

name: Your Blog's Name
description: A description for your blog

author: Your Name (optional)

This makes it easy to reference the title, description and URL for your site in the feed templates using {{ }}, {{ site.description }} and {{ site.url }}. Even if you're not using these feed templates, you might find these variables useful when you're designing your layouts.

Looking for the RSS version?

If you missed the link at the top please also checkout the original incarnation of this project:

You can’t perform that action at this time.