RSS and Sitemap

April 16, 2026 · 1 min read

documentation onyxfolio

Contents

Site-wide RSS feed
Per-section RSS feed
Feed format
Sitemap
Linking to feeds
See also

OnyxFolio auto-generates RSS feeds and a sitemap for every deployment — no configuration needed.

Site-wide RSS feed

URL: /feed.xml

Contains the 20 most recent published posts across all sections, sorted by date (newest first).
Each item includes: title, link, GUID, pubDate, and description (the post summary).
The feed title and link use WEBSITE_NAME (from the root homepage title).

Per-section RSS feed

URL: /<section>/feed.xml

Example: /blog/feed.xml, /gallery/feed.xml

Contains the 20 most recent posts in that section (including sub-sections), sorted by date.
The section must have a registered route (a type: listing or type: homepage note, or an auto-generated listing).
Returns 404 if the section doesn't exist.

Feed format

Both feeds are valid RSS 2.0 XML:

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
    <title>My Site</title>
    <link>https://example.com</link>
    <description>My Site</description>
    <lastBuildDate>...</lastBuildDate>
    <item>
      <title>Post Title</title>
      <link>https://example.com/blog/post-slug</link>
      <guid>https://example.com/blog/post-slug</guid>
      <pubDate>Wed, 16 Apr 2026 00:00:00 +0000</pubDate>
      <description>Post summary text...</description>
    </item>
    ...
  </channel>
</rss>

Sitemap

URL: /sitemap.xml

Auto-generated sitemap that lists every public URL on the site:

The root /
All section root URLs (from SECTION_ROUTES)
All regular post URLs (from ALL_POSTS)

Format: XML Sitemap Protocol 0.9.

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url><loc>https://example.com/</loc></url>
  <url><loc>https://example.com/blog</loc></url>
  <url><loc>https://example.com/blog/my-post</loc></url>
  ...
</urlset>

Private notes, tag archive pages, and search/tags index pages are not included.

Linking to feeds

Add feed autodiscovery to your site by referencing the feed URL in templates, or simply share the URL with subscribers. Most RSS readers also auto-detect /feed.xml.