RSS

Usage

This plugin is included in fumapress and enabled by default through the recommended preset. It serves a /rss.xml feed of your pages, newest first, and links it from the document head so feed readers can discover it.

To customize it, add the plugin with options, it takes priority over the preset:

import { defineConfig } from "fumapress";
import { rssPlugin } from "fumapress/plugins/rss";

export default defineConfig({
  // ...
})
  .plugins(
    rssPlugin({
      title: "My Docs",
      description: "Updates from my documentation",
      language: "en-us",
    }),
  );

title defaults to site.name. Set site.baseUrl so item links and the feed's self link resolve to absolute URLs.

Options

getItem

Controls how a page becomes a feed item. Pages are dated with the creation date from your content source (e.g. the date frontmatter with Fumadocs MDX), falling back to the last modified date, undated pages are excluded.

Override it to change titles, add categories, or filter pages, return undefined to exclude one:

rssPlugin({
  async getItem(page) {
    if (!page.url.startsWith("/blog/")) return;

    return {
      title: page.data.title,
      link: new URL(page.url, this.siteConfig.baseUrl).href,
      description: page.data.description,
      pubDate: await this.getPageCreatedAt(page),
    };
  },
});

additionalItems

Extra items to include, as an array or a function returning one. Useful for entries that are not pages of your content source:

rssPlugin({
  additionalItems: [
    {
      title: "Introducing Fumapress",
      link: "https://example.com/blog/introducing-fumapress",
      pubDate: new Date("2026-06-01"),
    },
  ],
});

limit

Maximum number of items, defaults to 20.

alternateLink

Whether to add the <link rel="alternate"> discovery tag to all pages, defaults to true.

path

The route path, defaults to /rss.xml.

Custom Feeds

For additional feeds, the buildRSS function serializes a channel to XML, serve it from your own API route:

import { buildRSS } from "fumapress/plugins/rss";

export async function GET() {
  return new Response(
    buildRSS({
      title: "My Blog",
      link: "https://example.com/blog",
      description: "Posts from my blog",
      items: [
        {
          title: "Hello World",
          link: "https://example.com/blog/hello-world",
          pubDate: new Date("2026-08-29"),
        },
      ],
    }),
    {
      headers: { "Content-Type": "application/rss+xml" },
    },
  );
}