18-Nov-2026 | v7.13.1 | All new article.
Contributors:
rssFeed
This component outputs content from your internal and external RSS Feeds on site pages.
{% component type: "rssFeed", source: "<Feed name>", layout: "<Layout name>" %}
For details on creating and managing feeds, see the RSS Feeds article.
Parameters and Options
rssFeedThis is the name of the entity that needs to be used for the component retrieving function.
<Feed name>The name of the internal or external feed that the data is to be sourced from.
sourceUrl
filePathFor external feeds only. Specifies whether the feed is referenced by its 'Source URL' or its 'File Path'.
Content is always read from the feed's saved file. The external source is never requested when the page renders.
<Your Layout name>The layout name you want to use for rendering the component. The layout name is referenced from the available layouts of the source feed specified.
If this parameter is blank or references a layout that does not exist, the feed data can still be accessed via the collectionVariable parameter.
10 (default)
<integer>The maximum number of feed entries returned.
<yourLiquidVariableName>Assigns the feed data to a Liquid collection, enabling custom rendering of the data on the Page or Template using Liquid.
Your collectionVariable value must only contain English letters, numbers or underscores. Spaces or special characters are not supported.
Component Manager
Rather than writing the component tag by hand, open the 'Components' panel in the page editor and select 'RSS Feeds'. Choose "Internal Feed" or "External Feed", configure the parameters and copy the generated code into your page or template.
Examples
Outputting the 5 most recent entries of an internal feed using its "List" layout:
{% component type: "rssFeed", source: "Main Blog", layout: "List", limit: "5" %}
Outputting an external feed referenced by its file path:
{% component type: "rssFeed", source_type: "filePath", source: "A List Apart", layout: "List" %}
Liquid Output
Both feed types return the same feed-level wrapper, with the feed entries in the Items array.
null if not set.null if not set.1440 for a feed updated once a day.Internal Feed Output
For internal feeds, each entry in Items contains the same properties as the source module's items, including any custom properties. The example below is a "Blog Post" source with 2 sample items, with the 'Description' values shortened.
{
"Name": "Main Blog",
"Description": null,
"Link": null,
"SiteOrigin": "https://www.yoursite.com",
"AbsoluteUrl": "https://www.yoursite.com/rss/blog.rss",
"LastBuildAt": "2026-11-18T02:55:49.2467409Z",
"TtlMinutes": 1440,
"Generator": "Your Site Name",
"SiteId": 12345,
"Items": [
{
"Id": 2507,
"ModuleLayoutName": "Post Detail",
"Enabled": true,
"ReleaseDate": "2026-06-09T00:00:00",
"ExpiryDate": "2099-12-31T00:00:00",
"Weighting": 0,
"Item_Rating": 0,
"DnDOrder": 0,
"CodeEditor": false,
"ExternalId": 0,
"DisableForSiteSearch": false,
"Author_Name": null,
"Author_Url": null,
"Author": 0,
"SEOTitle": null,
"LastUpdatedDate": "2026-06-09T19:44:19.310835",
"Module_Alias": "BlogPost",
"Module_Id": 1534,
"ParentName": "Web Developers Corner",
"ParentUrl": "/web-developers-corner",
"CreatedByMemberId": 0,
"Name": "Mastering CSS Animation Techniques for SVGs",
"UrlSlug": "mastering-css-animation-techniques-for-svgs",
"Url": "/web-developers-corner/mastering-css-animation-techniques-for-svgs",
"MetaDescription": null,
"ShowPageForSearchEngine": true,
"CanonicalLink": null,
"MetaTitle": null,
"ParentId": 1915,
"Url_List": [
"/web-developers-corner/mastering-css-animation-techniques-for-svgs"
],
"ParentId_List": [
1915
],
"EnableAMP": false,
"AMPContent": null,
"SocialMetaTags": null,
"SeoPriority": 0.5,
"Description": "Scalable Vector Graphics (SVGs) have become an essential part of modern web design...",
"TemplateName": null,
"ItemCategories": null,
"ItemCategoryIdList": null,
"ItemTags": null,
"SiteSearchKeywords": [
"CSS SVG animation",
"SVG keyframe animation"
],
"IsHome": false,
"OpenGraphProperties": {
"title": null,
"type": null,
"url": null,
"locale": null,
"image": null
},
"Params": {}
},
{
"Id": 2506,
"ModuleLayoutName": "Post Detail",
"Enabled": true,
"ReleaseDate": "2026-06-09T00:00:00",
"ExpiryDate": "2099-12-31T00:00:00",
...
"Name": "Modern CSS and the use of Custom Properties",
"UrlSlug": "modern-css-and-the-use-of-custom-properties",
"Url": "/web-developers-corner/modern-css-and-the-use-of-custom-properties",
...
"Description": "CSS Custom Properties, also known as CSS variables, have changed the way we write stylesheets...",
...
}
],
"Params": {
"source": "Main Blog",
"layout": "List",
"limit": "2",
"type": "rssFeed"
}
}
External Feed Output
For external feeds, each entry in Items contains the fields supplied by the source feed, normalised into a consistent set of properties regardless of the source format. The example below has 2 sample items, with the 'DescriptionHtml' values shortened.
{
"Name": "A List Apart",
"Description": "Articles for people who make web sites.",
"Link": "https://alistapart.com/",
"SiteOrigin": "https://www.yoursite.com",
"AbsoluteUrl": "https://www.yoursite.com/rss/alistapart.rss",
"LastBuildAt": "2026-11-18T02:55:49.2173925Z",
"TtlMinutes": 1440,
"Generator": "Your Site Name",
"SiteId": 12345,
"Items": [
{
"Title": "Designed for a Dead Language",
"Link": "https://alistapart.com/article/designed-for-a-dead-language/",
"Guid": "https://alistapart.com/article/designed-for-a-dead-language/",
"IsGuidPermaLink": true,
"PubDate": "2026-06-30T16:22:27Z",
"Author": "by Shrey Shah",
"Categories": [],
"DescriptionHtml": "<p>Article summary content...</p>",
"ContentHtml": null,
"EnclosureUrl": null,
"EnclosureLength": null,
"EnclosureType": null
},
{
"Title": "Good designers, bad websites: a proposal",
"Link": "https://alistapart.com/article/good-designers-bad-websites-a-proposal/",
"Guid": "https://alistapart.com/article/good-designers-bad-websites-a-proposal/",
"IsGuidPermaLink": true,
"PubDate": "2026-04-23T12:57:21Z",
"Author": "by Alan Dalton",
"Categories": [],
"DescriptionHtml": "<p>Article summary content...</p>",
"ContentHtml": null,
"EnclosureUrl": null,
"EnclosureLength": null,
"EnclosureType": null
}
],
"Params": {
"type": "rssFeed",
"source_type": "filePath",
"source": "A List Apart",
"layout": "List",
"limit": "2"
}
}
Accessing the Data
JSON Output
You can output the full JSON for your component data by referencing the root Liquid object {{this}} in your feed's layouts, or directly on your page if using the collectionVariable parameter in your component tag.
For example:
{% component type: "rssFeed", source: "A List Apart", collectionVariable: "myFeed" %}
You can then render the JSON like so:
{{myFeed}}
For more details on this approach, see Part 2 of the free 'Learning Liquid Course'.
Rendering Property Values
This data is accessible in two main ways:
1. Using Liquid in the specified Layout via the this object.
{{this['Name']}}
2. Directly on the Page or Template via a Liquid Collection if collectionVariable was added to the Component tag.
An example using collectionVariable with value "blogFeed" for an internal feed, looping through the items to render a list of linked post names:
{% component type: "rssFeed", source: "Main Blog", collectionVariable: "blogFeed" %}
<ul>
{% for i in blogFeed.items %}
<li><a href="{{i['Url']}}">{{i['Name']}}</a></li>
{% endfor %}
</ul>
An example using collectionVariable with value "alaFeed" for an external feed. Note that external feed items use the property names supplied by the source feed, such as Title and PubDate:
{% component type: "rssFeed", source_type: "filePath", source: "A List Apart", collectionVariable: "alaFeed" %}
<ul>
{% for i in alaFeed.items %}
<li>
<a href="{{i['Link']}}" rel="nofollow noopener">{{i['Title']}}</a>
<small>{{i['PubDate'] | date: "%d %b %Y"}}</small>
</li>
{% endfor %}
</ul>