Skip to main content

​
Release notes hub RSS (Mintlify)

​
Root cause (why the hub had no <item> elements)

The visual hub (updates/release-notes.mdx) uses mode: frame. On staging we verified:
  • …/updates/release-notes/rss.xml had a <channel> but no <item> elements.
  • …/web-sdk/product-updates/changelog/rss.xml and …/updates/mar2026-release-notes/rss.xml did include items.
So Mintlify’s RSS builder does not pull <Update> entries from frame-mode pages, even if those components appear in the MDX source. It is not caused by CSS hiding; moving <Update> blocks outside the layout did not fix it while mode: frame stayed on that file.

​
Fix: separate RSS source page (no frame)

  1. updates/release-notes-rss-feed.mdx
    • rss: true, hidden: true (sidebar), no mode: frame.
    • Holds the combined monthly <Update> list (newest first).
    • Feed URL: /updates/release-notes-rss-feed/rss.xml
  2. updates/release-notes.mdx
    • Keeps mode: frame and the custom timeline UI.
    • No rss: true on this file (so we do not publish an empty feed at …/release-notes/rss.xml).
    • The RSS control links to /updates/release-notes-rss-feed/rss.xml.

​
When you add a new month

  1. Update the timeline on release-notes.mdx as usual (newest month first under the year heading).
  2. Add a matching <Update> at the top of the list in release-notes-rss-feed.mdx (same pattern as existing entries; see April 2026 / updates/apr2026-release-notes).
  3. Add the page path to docs.json under Release Notes (e.g. updates/apr2026-release-notes before older months).
  4. For the monthly MDX page, include rss: true in frontmatter when that month’s page should participate in per-page RSS (see updates/apr2026-release-notes.mdx).

​
How to test

After deploy, open https://<host>/updates/release-notes-rss-feed/rss.xml and confirm <item> entries.
Last modified on April 1, 2026