Files
homepage/docs/widgets/services/feed.md
T
2026-09-24 16:39:22 -07:00

1.4 KiB

title, description
title description
Feed RSS / Atom feed widget

This widget shows the latest items from an RSS 2.0 or Atom feed.

widget:
  type: feed
  url: https://feeds.bbci.co.uk/news/rss.xml
  maxItems: 5 # optional - defaults to 5
  layout: list # optional - possible values list, grid - defaults to list
  images: true # optional - set to false to hide images - defaults to true

Layouts

list shows one row per item. Items with an image get a small thumbnail.

Feed widget list layout

Feed widget list layout with thumbnails

grid shows image tiles that re-flow to fit the width of the widget, e.g.:

- World News:
    widget:
      type: feed
      url: https://feeds.bbci.co.uk/news/world/rss.xml
      layout: grid
      maxItems: 8

Feed widget grid layout

Images

Images are taken from the feed's media:thumbnail / media:content tags or image enclosures, falling back to the first image in the item's content. Some feeds do not include images at all.

Images are loaded by your browser directly from the feed's host, at whatever size the feed provides. Feeds that link full-size originals can be slow to load; set images: false for those.

Notes

Feeds are fetched by homepage, not your browser, and cached for 10 minutes.