RSS feed

Table of Contents

 

If your RSS feed does not work in the workspace, please check the URL using a tester and resolve any errors before contacting support.

Introduction

You can show multiple RSS feeds in your digital workplace. Use the drop-down menu from the tile to switch between the feeds. You can add two types of feeds:

  • Public feed
  • SharePoint feed

mceclip0.png

 

Definition and usage

General:

    • You can add two types of feeds; only Atom 1.0 and RSS 2.0 are supported.
    • Workspace has no influence on the layout/structure of the feed.

SharePoint RSS feed:

    • Before you add the SharePoint RSS feed, in Workspace admin settings page, check if the correct Company's SharePoint URL has been filled in. This must be the root URL.
    • Workspace looks at posts' published date to determine the order in which they are displayed. It is not possible to apply a filter for a different order from the Workspace.
    • The thumbnail picture of a post is set as the picture displayed as the thumbnail of the post in the RSS feed in Workspace.

Images:

    • The <image> element allows an image to be displayed when aggregators present a feed.
    • The child elements <link>, <title>and <url> are required.
    • Only JPEG and PNG are supported.


Images are missing

Some child elements of the <image> element are required. If these are missing, images will not be visible in the RSS feed. For SharePoint RSS feeds, you need to open SharePoint once in the browser in order for images to be displayed in the RSS feed tile.

To check the differences in the code between an image that is retrieved and an image that is not:

  1. Press F12. This opens the browser console.
  2. Press CTRL + SHIFT + C (or click on the arrow in the upper left corner).
  3. Select an image.
  4. Inspect the code and compare images.
    • It must contain the <image> element.
    • It must contain the child elements <link>, <title>and <url>.
    • Check the image type (JPEG or PNG).

Tag Description
<description> Optional. Specifies the text in the HTML title attribute of the link around the image.
<height> Optional. Defines the height of the image.
<link> Required. Defines the hyperlink to the website that offers the channel.
<title> Required. Defines the text to display if the image could not be shown.
<url> Required. Specifies the URL to the image.
<width> Optional. Defines the width of the image.

Back to top

 

Add the RSS feed to Workspace

  1. Go to the App store (or click on "+ Add tiles").
  2. Click Create tile.
  3. Select RSS (it also can be found under the "Web" category).
  4. Click Create.
  5. It's optional to configure the app icon, color and tile size.
  6. Give the news feed tab a name. This name will be displayed in the live tile.
  7. Choose the Feed type matching your feed.
  8. Retrieve the RSS feed URL from your website or SharePoint.
  9. Configure the Site URL (where the "Open site" links to).
  10. To create multiple RSS feeds click on the + icon.
  11. Press the - icon to remove feeds. 
  12. It's optional to change the order of the RSS tabs.
  13. Now, add the RSS feed to Workspace, either to a new or existing tile group.
  14. Don't forget to click save when you're done.

edit_rss.PNG


"The contents of this RSS feed cannot be read"

ContentCannotBeRead.png

When trying to add the RSS tile you may run into the error mentioned above. This happens when you have an incorrect SharePoint URL (e.g. https://companyname-admin.sharepoint.com) configured in the SharePoint settings.

  1. Go to the Workspace admin settings page.
  2. Select Integrations.
  3. Go to SharePoint documents.
  4. Change the Company's SharePoint URL to the correct root URL. It should have the following format: https://companyname.sharepoint.com

Back to top