Examples
Example syndication documents
These examples show how existing syndication feed pages could be represented as
/.well-known/syndication documents.
BBC
This example is not endorsed by, affiliated with, or published by the BBC. It was created by scanning the public BBC News feeds page, checking representative BBC Sport RSS endpoints, and translating those feeds into this draft format.
BBC is a useful example because feeds naturally fall under segments such as BBC News and BBC Sport. Collections let a reader present those groups without scraping several full pages.
The full OPML catalogue at news.bbc.co.uk/rss/feeds.opml contains
1,725 feeds. This example shows a compact syndication document with deferred
collection URLs, so a reader can present the groups first and fetch the
detailed feed lists only when needed.
This example advertises 46 feeds divided into 2 deferred collections.
- BBC News
- 39 feeds
- BBC Sport
- 7 feeds
{
"version": "https://syndicationmanifest.org/spec/0.1",
"publication": {
"name": "BBC",
"uri": "https://www.bbc.co.uk/",
"description": "Example syndication document for BBC public feeds.",
"language": "en-GB",
"categories": [
"news",
"sport"
]
},
"collections": [
{
"id": "news",
"title": "BBC News",
"uri": "https://www.bbc.co.uk/news/",
"description": "Public RSS feeds advertised by BBC News.",
"language": "en-GB",
"categories": [
"news"
],
"feed_count": 39,
"feeds_uri": "https://www.bbc.co.uk/.well-known/syndication/news"
},
{
"id": "sport",
"title": "BBC Sport",
"uri": "https://www.bbc.co.uk/sport/",
"description": "Representative public RSS feeds from BBC Sport.",
"language": "en-GB",
"categories": [
"sport"
],
"feed_count": 7,
"feeds_uri": "https://www.bbc.co.uk/.well-known/syndication/sport"
}
]
} {
"version": "https://syndicationmanifest.org/spec/0.1",
"publication": {
"name": "BBC Sport",
"uri": "https://www.bbc.co.uk/sport/",
"description": "Example deferred collection document for BBC Sport feeds.",
"language": "en-GB",
"categories": [
"sport"
]
},
"feeds": [
{
"uri": "https://feeds.bbci.co.uk/sport/rss.xml",
"mime_type": "application/rss+xml",
"format_version": "2.0",
"rel": [
"self",
"canonical"
],
"title": "Top Stories",
"language": "en-GB",
"categories": [
"sport"
],
"home_page_uri": "https://www.bbc.co.uk/sport/"
},
{
"uri": "https://feeds.bbci.co.uk/sport/football/rss.xml",
"mime_type": "application/rss+xml",
"format_version": "2.0",
"title": "Football",
"language": "en-GB",
"categories": [
"sport",
"football"
]
},
{
"uri": "https://feeds.bbci.co.uk/sport/cricket/rss.xml",
"mime_type": "application/rss+xml",
"format_version": "2.0",
"title": "Cricket",
"language": "en-GB",
"categories": [
"sport",
"cricket"
]
},
{
"uri": "https://feeds.bbci.co.uk/sport/formula1/rss.xml",
"mime_type": "application/rss+xml",
"format_version": "2.0",
"title": "Formula 1",
"language": "en-GB",
"categories": [
"sport",
"formula-1"
]
},
{
"uri": "https://feeds.bbci.co.uk/sport/rugby-union/rss.xml",
"mime_type": "application/rss+xml",
"format_version": "2.0",
"title": "Rugby Union",
"language": "en-GB",
"categories": [
"sport",
"rugby-union"
]
},
{
"uri": "https://feeds.bbci.co.uk/sport/tennis/rss.xml",
"mime_type": "application/rss+xml",
"format_version": "2.0",
"title": "Tennis",
"language": "en-GB",
"categories": [
"sport",
"tennis"
]
},
{
"uri": "https://feeds.bbci.co.uk/sport/golf/rss.xml",
"mime_type": "application/rss+xml",
"format_version": "2.0",
"title": "Golf",
"language": "en-GB",
"categories": [
"sport",
"golf"
]
}
]
} Daring Fireball
This example is not endorsed by, affiliated with, or published by Daring Fireball. It was created by scanning the public Daring Fireball feeds page and translating the discovered feeds into this draft format.
The page's <head> advertises the main Atom feed and
JSON Feed. The articles-only feed and podcast feed are listed on the
feeds page, which means feed readers need to scrape the page or users
need to know where to look.
A /.well-known/syndication document puts those feeds in a reader-friendly
place with appropriate metadata. This example also includes the Daring
Fireball YouTube channel to show how a publication can advertise an
external feed.
This example advertises 5 feeds in a single document, without collections.
{
"version": "https://syndicationmanifest.org/spec/0.1",
"publication": {
"name": "Daring Fireball",
"uri": "https://daringfireball.net/",
"description": "Example syndication document for Daring Fireball feeds.",
"language": "en",
"categories": [
"technology",
"blog",
"podcast",
"video"
]
},
"feeds": [
{
"uri": "https://daringfireball.net/feeds/main",
"mime_type": "application/atom+xml",
"format_version": "1.0",
"rel": [
"self",
"canonical"
],
"title": "Daring Fireball",
"description": "Main feed for everything on Daring Fireball.",
"language": "en",
"categories": [
"technology",
"blog"
],
"home_page_uri": "https://daringfireball.net/"
},
{
"uri": "https://daringfireball.net/feeds/json",
"mime_type": "application/feed+json",
"format_version": "1.1",
"rel": [
"alternate"
],
"title": "Daring Fireball JSON Feed",
"description": "JSON Feed version of the main Daring Fireball feed.",
"language": "en",
"categories": [
"technology",
"blog"
],
"home_page_uri": "https://daringfireball.net/"
},
{
"uri": "https://daringfireball.net/feeds/articles",
"mime_type": "application/atom+xml",
"format_version": "1.0",
"rel": [
"alternate"
],
"title": "Daring Fireball Articles",
"description": "Articles-only feed.",
"language": "en",
"categories": [
"technology",
"blog",
"articles"
],
"home_page_uri": "https://daringfireball.net/"
},
{
"uri": "https://daringfireball.net/thetalkshow/rss",
"mime_type": "application/rss+xml",
"format_version": "2.0",
"rel": [
"alternate"
],
"title": "The Talk Show With John Gruber",
"description": "Podcast feed for The Talk Show.",
"language": "en",
"categories": [
"podcast",
"technology"
],
"home_page_uri": "https://daringfireball.net/thetalkshow/"
},
{
"uri": "https://www.youtube.com/feeds/videos.xml?channel_id=UC5IxPw1YtEZLvwicHpbg4Wg",
"mime_type": "application/atom+xml",
"format_version": "1.0",
"rel": [
"alternate"
],
"title": "Daring Fireball on YouTube",
"description": "External video feed for the Daring Fireball YouTube channel.",
"language": "en",
"categories": [
"video",
"technology"
],
"home_page_uri": "https://www.youtube.com/daringfireball"
}
]
} Stuart Breckenridge
This example is based on the public feeds table on
stuartbreckenridge.net/about.
The page advertises RSS, Atom, and JSON Feed alternates in
<head>, then lists more feed variants in the body.
A Syndication Manifest document can turn that into three reader-facing collections: All posts, Featured, and Links. Each collection carries the RSS, Atom, and JSON Feed version of the same stream.
This example advertises 9 feeds divided into 3 inline collections.
{
"version": "https://syndicationmanifest.org/spec/0.1",
"poll_interval_seconds": 3600,
"publication": {
"name": "Stuart Breckenridge",
"uri": "https://stuartbreckenridge.net/",
"description": "Personal blog by Stuart Breckenridge. App development, Apple ecosystem, cycling, and more.",
"language": "en",
"icon": "https://stuartbreckenridge.net/apple-touch-icon-v20260420.png",
"categories": [
"personal blog",
"technology",
"apple",
"open web"
]
},
"collections": [
{
"id": "all-posts",
"title": "All posts",
"uri": "https://stuartbreckenridge.net/",
"description": "All public posts from stuartbreckenridge.net.",
"language": "en",
"categories": [
"blog"
],
"feeds": [
{
"uri": "https://stuartbreckenridge.net/feed.json",
"mime_type": "application/feed+json",
"format_version": "1.1",
"rel": [
"self",
"canonical"
],
"title": "Stuart Breckenridge",
"description": "JSON Feed for all posts.",
"language": "en",
"categories": [
"blog"
],
"home_page_uri": "https://stuartbreckenridge.net/"
},
{
"uri": "https://stuartbreckenridge.net/atom.xml",
"mime_type": "application/atom+xml",
"format_version": "1.0",
"rel": [
"alternate"
],
"title": "Stuart Breckenridge",
"description": "Atom feed for all posts.",
"language": "en",
"categories": [
"blog"
],
"home_page_uri": "https://stuartbreckenridge.net/"
},
{
"uri": "https://stuartbreckenridge.net/rss.xml",
"mime_type": "application/rss+xml",
"format_version": "2.0",
"rel": [
"alternate"
],
"title": "Stuart Breckenridge",
"description": "RSS feed for all posts.",
"language": "en",
"categories": [
"blog"
],
"home_page_uri": "https://stuartbreckenridge.net/"
}
]
},
{
"id": "featured",
"title": "Featured",
"uri": "https://stuartbreckenridge.net/featured/",
"description": "Featured posts from stuartbreckenridge.net.",
"language": "en",
"categories": [
"featured"
],
"feeds": [
{
"uri": "https://stuartbreckenridge.net/featured/feed.json",
"mime_type": "application/feed+json",
"format_version": "1.1",
"rel": [
"self",
"canonical"
],
"title": "Stuart Breckenridge: Featured",
"description": "JSON Feed for featured posts.",
"language": "en",
"categories": [
"featured"
],
"home_page_uri": "https://stuartbreckenridge.net/featured/"
},
{
"uri": "https://stuartbreckenridge.net/featured/atom.xml",
"mime_type": "application/atom+xml",
"format_version": "1.0",
"rel": [
"alternate"
],
"title": "Stuart Breckenridge: Featured",
"description": "Atom feed for featured posts.",
"language": "en",
"categories": [
"featured"
],
"home_page_uri": "https://stuartbreckenridge.net/featured/"
},
{
"uri": "https://stuartbreckenridge.net/featured/rss.xml",
"mime_type": "application/rss+xml",
"format_version": "2.0",
"rel": [
"alternate"
],
"title": "Stuart Breckenridge: Featured",
"description": "RSS feed for featured posts.",
"language": "en",
"categories": [
"featured"
],
"home_page_uri": "https://stuartbreckenridge.net/featured/"
}
]
},
{
"id": "links",
"title": "Links",
"uri": "https://stuartbreckenridge.net/links/",
"description": "Linked-list posts from stuartbreckenridge.net.",
"language": "en",
"categories": [
"links"
],
"feeds": [
{
"uri": "https://stuartbreckenridge.net/links/feed.json",
"mime_type": "application/feed+json",
"format_version": "1.1",
"rel": [
"self",
"canonical"
],
"title": "Stuart Breckenridge: Links",
"description": "JSON Feed for linked-list posts.",
"language": "en",
"categories": [
"links"
],
"home_page_uri": "https://stuartbreckenridge.net/links/"
},
{
"uri": "https://stuartbreckenridge.net/links/atom.xml",
"mime_type": "application/atom+xml",
"format_version": "1.0",
"rel": [
"alternate"
],
"title": "Stuart Breckenridge: Links",
"description": "Atom feed for linked-list posts.",
"language": "en",
"categories": [
"links"
],
"home_page_uri": "https://stuartbreckenridge.net/links/"
},
{
"uri": "https://stuartbreckenridge.net/links/rss.xml",
"mime_type": "application/rss+xml",
"format_version": "2.0",
"rel": [
"alternate"
],
"title": "Stuart Breckenridge: Links",
"description": "RSS feed for linked-list posts.",
"language": "en",
"categories": [
"links"
],
"home_page_uri": "https://stuartbreckenridge.net/links/"
}
]
}
]
}