RSS Feed widget

The RSS Feed widget allows you to display the contents of public RSS feeds from external websites in your digital workplace. Users can select the titles of these feeds to go to the source content.

The RSS widget on a page displaying a feed of items from a news site.

Sections in this article:

Set up

Follow these steps to set up this widget:

  1. Place a  RSS Feed widget on a page, space, or dashboard. For more information, see Placing and setting up a widget
  2. Select the placed widget's Edit button.
  3. Review and make changes to the settings on the Options, Layout, and Appearance tabs. You can find details about the widget's settings in the Settings section below.
  4. In the widget editor, select Update to apply your changes or Cancel to discard them.  
  5. At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.

Settings

Setting Description
Title

Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections.

When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a title for each supported language. 

This field can contain a maximum of 140 characters.

Description

Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide information to users about the widget.

When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a description for each supported language.

Feed URLs Enter the URL of an RSS feed. This URL must be public and not require authentication. An example of an RSS feed is https://rss.cbc.ca/lineup/sports-nhl.xml.

To add additional RSS feeds to the widget, select + Add Another to add another text box where you can enter the URL of an RSS Feed.

To remove an RSS feed from the widget, select the X next to its URL.
Number of results Enter the maximum number of results to display. You must enter a value between 1 and 99. Users cannot load additional results.
Options tab
Setting Description
Date Select whether the date of the feed item is shown under its title.
Source Select whether the source of the feed item is shown under its title.
Body Select whether the body of the feed item is shown under its title. Depending on the feed, this may not be the entire body.
Layout tab
Setting Description
Class Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets.
Height Select the height of the widget. Options include:
  • Auto: The leftmost slider position. The height of the widget will increase and decrease to contain what it is displaying.
  • Fixed: Select a fixed height between 50px to 600px in increments of 50px. A vertical scrollbar will appear on the widget if the content exceeds this fixed value.
Appearance tab

Note

Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.