# RSS feed Pulls the latest items from one or more RSS or Atom feeds onto the page, as a list, a table or an image gallery. ![A Confluence page with a News heading followed by five feed items, each with a thumbnail image, a linked headline, a date and a short summary, above a show more button.](https://help.gocapable.com/images/191329aa-4416-4508-a761-5aff7665c4e4.webp) A news feed pulled into a page, each item carrying its thumbnail, headline, date and summary, with more held behind a show more button. Teams keep pasting the same links into the same page and it goes stale within a week. This macro reads live RSS or Atom feeds and renders the newest items in place: company blog posts on a space home, a vendor's changelog on a runbook, industry headlines on a team dashboard. Add several feeds and they merge into a single newest-first stream with the source name beside each date. Reach for it whenever the value of a page is "what has happened recently" and you do not want to be the person maintaining it. It also ships three ready-made starting points and a picker of well-known feeds, so a useful version is about four clicks away. ![](https://help.gocapable.com/images/0655fe6c-298a-4583-ac98-5c1095e9e533.webp) The macro is inserted from the editor with a slash command. --- ## See it Every example below is a real macro on this page, not a screenshot, and each one is a configuration taken from a page somebody actually built. Open this page in the editor to see how any of them is set up. ### Articles with images RSS feeds are not available on published sites. A published page is static, so the feed cannot be refreshed after the site is deployed. ### Articles RSS feeds are not available on published sites. A published page is static, so the feed cannot be refreshed after the site is deployed. ### Table RSS feeds are not available on published sites. A published page is static, so the feed cannot be refreshed after the site is deployed. ### Grid RSS feeds are not available on published sites. A published page is static, so the feed cannot be refreshed after the site is deployed. --- ## Settings ![The RSS feed configuration panel listing two feed addresses with an add feed button, a display toggle set to articles with images, and an item limit of three, with three sports stories previewed to th](https://help.gocapable.com/images/ea008b56-58f8-4008-b27a-0169f5dbdfcc.webp) Several feeds can be listed and dragged into order, and the display choice and item limit sit underneath them. | **Setting** | **Values** | **What it changes** | | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | RSS Feeds, Feed URL | Pick from the built-in suggestions (Capable Blog, TechCrunch, BBC News, Engadget, Microsoft Blog, Facebook Engineering Blog, NASA Breaking News, Atlassian Forge Changelog, XKCD) or paste any RSS/Atom URL. Feeds are added, reordered by dragging and deleted individually. | The feeds to read. Items from every feed are merged and sorted newest-first. | | RSS Feeds, Name (optional) | Free text (placeholder: "e.g. Company Blog") | A label for that feed, shown next to each item's date. Described in the panel as "Shown next to the date when more than one feed is added". | | Display | Articles ("Display articles in a simple list format") / Articles with Images ("Display articles with thumbnail images") / Table ("Display articles in a table format") / Gallery ("Display articles in a grid gallery with image backgrounds") | The layout. Chosen from four illustrated cards on the Style tab. | | Item limit | 1–500 | How many items are shown initially. Described as "Maximum number of items to display". If the feed has more, a "Show More..." button appears and reveals another batch each press, with a "Collapse" link to go back. | | Columns | Responsive, or a fixed 1–6 columns | Described as "Responsive fits columns to the available width; or pick a fixed count". Responsive fits as many columns as the page width allows, for the article layouts that means it stays single-column until roughly 920px wide, b | | Gap | 0–48 px slider | Spacing between items in the grid layouts. | | Corner radius | 0–24 px slider | Rounds article thumbnails and gallery card corners. | | Card shadow | None / S / M / L | Described as "Resting drop shadow on article and gallery cards". | | Border | Off / On; when on, a Width slider (0–6 px) and a colour picker | Described as "Adds a card surface to the article layouts and outlines gallery cards". Turning it on is one of the two ways to give the article layouts an actual card look. | | Show overlay | On / Off | Described as "Dark gradient drawn over each image behind the text", it is what keeps gallery card text readable over a bright photo. | | Show text | On / Off | Described as "Article title and date shown on each gallery card". Turn it off for a pure image wall. | | Link colour | A brand or custom colour, or cleared | Described as "Article title colour, and the gallery title's hover tint. Leave unset to use the theme accent". | | Card background | A brand or custom colour, or cleared | Described as "Fills the gallery cards, and gives the article layouts a card surface (so shadow, corners and border show). Leave unset for the default". | --- ## Related [CodeA read-only code block with syntax highlighting, optional line numbers, a copy button and a cho](https://help.gocapable.com/macros/code.html) [LaTeX mathRenders a block mathematical equation written in LaTeX, centred on its own line in the page.](https://help.gocapable.com/macros/latex-math.html) [Technical and dataThe rest of this family.](https://help.gocapable.com/macros/technical-and-data.html) --- _The largest family, and the most precise._