RECENT UPDATES:
18-Nov-2026 | v7.13.1 | All new article

Change Log

  • 18-Nov-2026 | v7.13.1 | All new article

Contributors:

{
  "id": 2418,
  "name": "Adam Wilson",
  "url": "/adam-wilson"
}
Adam Wilson - Logo Pogo

RSS Feeds

Publish your site's blogs, events and module content as RSS feeds, or bring third-party feeds into your website with automatic updates.

RSS Feeds let you share your website content with feed readers, aggregators and other platforms, and display content from external feeds on your own pages. You can find this feature under 'Content' > 'RSS Feeds'.

The 'RSS Feed' page has two tabs: 'Internal', for publishing your own content as a feed, and 'External', for connecting feeds from other websites. Both feed types share the same settings structure, and each feed has a 'Settings' tab and a 'Layout' tab.

RSS Feeds are available on the Business and Pro content plans:

  • Business - up to 5 internal and 5 external feeds
  • Pro - up to 15 internal and 15 external feeds

Managing RSS Feeds

Each tab lists the feeds of that type. Use the "Search" field to find a feed by name, and the "SORT BY" dropdown to sort the list by "Name", "Status" or "Last Updated". To add a new feed, select the relevant tab and click "CREATE NEW".

RSS Feed Internal List
Column
Description
Name

The feed name. Click it to edit the feed.

URL / Source URL

On the 'Internal' tab, the URL where the feed is published on your site. On the 'External' tab, the URL of the third-party feed being fetched.

Update Frequency

How often the feed is rebuilt or fetched.

Status

The current state of the feed, eg: "Active". If the most recent update failed, the error is shown here.

Last Updated

The date and time of the last successful update.

Click the more options icon () at the end of a row for the following actions:

  • "Preview" - opens the feed output in a new browser tab
  • "Duplicate" - creates a copy of the feed and its settings
  • "Edit" - opens the feed's settings
  • "Delete" - removes the feed

Feed names must be unique. When duplicating a feed, give the copy a new name.

Internal Feeds

An internal feed publishes content from a single source module, such as Blogs, Events or a Custom Module, at a permanent URL on your site. The URL serves valid RSS 2.0 and updates automatically, so subscribers always get your latest content.

Settings

The 'Settings' tab contains the 'Feed Settings' panel. When editing an existing feed, a status bar at the top of the panel shows the current status and the date of the last successful update.

RSS Feed Internal Settings
Field
Description
Feed Name

A unique name for the feed. This name is also used to reference the feed in the Liquid component.

URL

The path where the feed is published on your site, eg: "/rss/blog.rss". The path can be anything ending in .rss or .xml, but must not conflict with an existing page, item or redirect.

Click "Preview" to view the current feed output.

Source

The module whose items are published in the feed, eg: "Blog Post". Each feed uses a single source module.

A module selected as a feed source cannot be deleted until any feeds using it are deleted or switched to a different source.

Update Frequency

How often the feed is rebuilt with the latest content:

  • Many times a day (approximately every 4 hours - default)
  • Once a day
  • Several times a week

Changes to the feed settings or layout are applied immediately, regardless of this setting.

Limit

The number of items to included in the feed. The default is 100. Enter 0 for no limit. A warning is shown for values above 500, as very large feeds can be slow for feed readers to process.

Description

An optional description of the feed's content.

Link

The URL of the web page the feed represents (for example, the blog listing page). If it's left empty, the default layout falls back to the site's main URL.

Enable

Turns the feed on or off. A disabled feed returns a 404 error at its URL.

Feed Content

Only published, public items from the source module are included in the feed. Disabled, expired and secured items are excluded.

Items are sorted by 'Release Date', newest first. If the source module's 'Release Date' field is disabled, items are sorted by ID instead.

If a rebuild fails, for example due to an error in a custom layout, the feed continues to serve its last working version and the error is shown in the feed list.

External Feeds

An external feed connects to a third-party feed and saves its content to your site so you can display it on your pages. Supported formats are RSS 0.91, RSS 1.0, RSS 2.0, Atom and JSON Feed.

RSS Feed External List

Settings

As with internal feeds, the 'Feed Settings' panel shows a status bar with the current status and the date of the last successful update.

RSS Feed External Settings
Field
Description
Feed Name

A unique name for the feed. This name is also used to reference the feed in the Liquid component.

Source URL

The URL of the third-party feed, eg: "https://alistapart.com/main/feed/".

File Path

The location in the File Manager where the fetched feed is saved, eg: "/rss/alistapart.rss". The path must end in .rss or .xml.

Click "Preview" to view the saved feed file.

Update Frequency

How often the source feed is fetched:

  • Many times a day (approximately every 4 hours - default)
  • Once a day
  • Several times a week
Limit

The number of items to included in the feed. External feeds have a maxiumum of 500.

Description

An optional description of the feed's content.

Link

The URL of the web page the feed represents (for example, the blog listing page). If it's left empty, the default layout falls back to the source site's main URL.

Enable

Turns the feed on or off.

How External Feeds Update

When the source feed is fetched, its content is normalised and saved as a physical .rss or .xml file at the 'File Path' you specified, with up to 500 entries. Your pages read only from this saved file and never request the external source when rendering, so a slow or unavailable source does not affect your page load times.

On each successful update, the file is fully rebuilt from the current source content. Entries removed from the source feed are also removed from the file.

Feed parsing is strict and invalid feeds are not auto-corrected. If the source feed is invalid, the feed is marked with an error status and the parser details, including the reason and position of the error, are shown in the admin.

If the source is invalid, unavailable or too slow to respond, the existing file is not overwritten. The last successful version remains on your site until the next successful update.

Security

Content from external feeds is treated as untrusted and is cleaned before it is saved:

  • Scripts, iframes, event handlers, inline styles and other executable content are removed.
  • Only basic formatting, links and images are kept. Links must use http or https and always have rel="nofollow noopener" applied. Images must use https.
  • Any Liquid code in the external content is escaped and not executed.
  • Requests to external sources are limited to a 10 MB response size and a timeout.

Layouts

The 'Layout' tab of each feed lists the layouts used to render the feed's content. These work in the same way as other Module layouts, using Liquid to output the feed data within your own markup. See RSS Feeds Liquid component for more on how layouts work.

RSS Feed Layouts

Each feed includes a "Default" layout, which can be edited but not deleted. The "Default" layout is preconfigured as the RSS XML template used to generate the feed published at the feed's URL. You can customise it, for example to add extra item properties to the feed.

Click "CREATE NEW" to add your own layouts for displaying the feed on your site pages via the Liquid component, such as the "List" layout shown above. Use the edit icon () to modify a layout, or the delete icon () to remove it.

For internal feeds, changes to the "Default" layout are applied to the feed immediately. If the layout contains an error, the rebuild fails and the feed continues to serve its last working version, so preview the feed after saving changes.

Displaying RSS Feeds on Your Site

Feeds can be output on any page or template using the rssFeed Liquid component, for example:

{% component type: "rssFeed", source: "A List Apart", layout: "List", limit: "5" %}

The 'Components' panel in the page editor includes an 'RSS Feeds' item with "Internal Feed" and "External Feed" options, where you can configure the component and copy the generated code.

For the full list of parameters, see Component Type: RSS Feed.

Liquid Filters for XML and RSS Output

Three Liquid filters are available to help generate valid XML and RSS output in your layouts:

  • rfc822_date - formats a date in the RFC 822 format required by RSS
  • xml_escape - escapes characters that are reserved in XML
  • cdata - wraps HTML content in a CDATA section

For example, within an internal feed's "Default" layout:

<title>{{ this['Name'] | xml_escape }}</title>
<pubDate>{{ this['ReleaseDate'] | rfc822_date }}</pubDate>
<description>{{ this['Description'] | cdata }}</description>

Open API

Internal and external feeds can also be managed via the Open API for RSS Feeds, with full list, get, create, update and delete support. The same validations and plan limits apply as in the admin, and responses include the feed status, last updated date and details of the last build error.