rss Plugin


scully-plugin-rss is a routeDiscoveryDone plugin for Scully. A RSS Feed is created from your content using feed and showdown.

The rss feed is available at:


To change the filename of the feed, use the filename attribute in your rss.config.json file, as seen below. The default value is feed, but you can change it to whatever you'd like.


Install the RSS Feed plugin using the command

npm install @notiz/scully-plugin-rss --save-dev

Note: routeDiscoveryDone plugin requires @scullyio/scully in version ^1.0.5 or above to correctly parse date values from markdown front matter.


Import the plugin in the Scully config file

import { ScullyConfig } from '@scullyio/scully';
import '@notiz/scully-plugin-rss';

export const config: ScullyConfig = {
  projectRoot: './src/app',
  routes: {

It will run on only routes that include /blog unless specified otherwise in the rss.config.json file. The order of the posts will be oldest first unless the newestPostsFirst option is set in the config.

Create a rss.config.json in your root with the following properties:

  "title": "Your Title",
  "description": "Page description",
  "id": "",
  "link": "",
  "language": "en",
  "image": "",
  "favicon": "",
  "copyright": "2020",
  "generator": "Page description",
  "filename": "feed",
  "feedLinks": {
    "atom": "",
    "json": "",
    "xml": ""
  "outDir": "./dist/static",
  "categories": ["Categories", "of", "your", "choice"],
  "blogPostRouteSlug": "/blog",
  "newestPostsFirst": true

Each RSS Feed item attributes are currently assigned by the following scully route attributes.

RSS Feed Item Scully Route
title title
id slug
link Config Link + slug
description description
content articleHTML
author authors
contributor authors
date updatedAt | publishedAt

Your content should have the following frontmatter in your scully content:

title: Martial Arts Training
description: Best Martial Arts Training
publishedAt: 2020-03-25T10:12:00.000Z
updatedAt: 2020-03-25T10:12:00.000Z
published: true
  - training
  - rss
  - Bruce Lee