In This Article

How to add, reuse, and edit RSS Feed assets

What should I use it for?

RSS Feed assets allow you to embed RSS feeds into your guides. This could include feeds from various sources, such as blogs, news sites, discovery services, or databases, to name a few.

What shouldn't I use it for?

Although your LibGuides blogs do have RSS feeds, we recommend using a Blogs widget instead of an RSS feed asset to display recent blog posts. These widgets will allow you to choose how many posts to display, choose how much content to display for each post, and even filter posts by subject or user account. Once you've created your widget, you can add it to your guide using a Media/Widget asset.


Add a new RSS feed to a guide

To create a brand new RSS feed asset from scratch and add it to your guide:

  1. While editing your guide, click on the  Add / Reorder button at the bottom of the box where you want add this.
  2. Select RSS Feed from the dropdown menu.
  3. Give your feed a name in the Name field.
    • This is how the feed will be identified in your assets library.
  4. Enter the full URL to the RSS feed in the Feed URL field.
  5. To limit the number of posts that will display at once, enter a number in the # Items to Display field.
  6. To customize how the description of each post appears on the page, choose your preference from the Description Display options. (Note: some feed providers may display full article content in their feeds, while others only display excerpts.)
    • Display beneath item title: this will display the full text of the description on the page, right below the title.
    • Click on "info" icon: an info () icon will appear next to the title. When a user clicks it, a popover will appear displaying the description.
  7. In the Proxy Options settings, select whether or not a proxy is required to view the feed and/or its posts.
    • This RSS feed is restricted and must be read via the proxy server: select this option if the feed itself requires your proxy URL in order to display.
      • When enabled, LibGuides will automatically prepend your proxy URL to the feed URL.
      • Note: this requires your Admin to provide your library's proxy URL in your LibGuides system settings.
    • Add proxy URL to the front of the links within this feed: select this option if a user has to authenticate via your proxy before viewing a full post in your feed.
      • When enabled, LibGuides will automatically prepend your proxy URL to the URL for each RSS feed post.
      • Note: this requires your Admin to provide your library's proxy URL in your LibGuides system settings.
  8. Use the Position option to choose where the new asset should be inserted in the box. (Don't worry: you can always reorder it later.)
  9. Click the Save button.

Assigning subject categories

  1. If you would like to assign your RSS feed to a subject category, click on the Subject Associations tab and select the subject(s) to assign. This will allow you to filter your assets by subject in your assets library.

Selecting RSS Feed from the Add/Reorder dropdown

Creating a new RSS feed asset


Reuse an existing RSS feed

It's always best to reuse existing assets as much as possible. This will help reduce duplication in your assets library, while also making it easier to analyzing statistics for a particular asset.

To reuse an existing RSS feed from your assets library (Content > Assets):

  1. While editing your guide, click on the  Add / Reorder button at the bottom of the box where you want add this.
  2. Select RSS Feed from the dropdown menu.
  3. In the Add RSS Feed window, click on the Reuse Existing RSS tab.
  4. In the Search for RSS Feed field, start typing in the name of the asset you want to add.
  5. Select the asset you want to add from the list of results.
  6. A summary of the asset info will appear.
    • Not the asset you are looking for? No problem: search again and select a different one.
  7. By default, a mapping of the original asset will be added to your guide. If you would rather create a copy of the original asset, select the Copy checkbox.
    • Using a mapping is convenient because any changes made to the original asset will automatically be reflected on your guide.
    • The drawback of mapping is that you won't be able to edit the asset yourself (except for adding a custom description just for this one mapping).
    • If you need to customize more details of the asset, then select the Copy checkbox. This will create a standalone copy of the asset that you own and can fully customize.
  8. Use the Position dropdown to select where in the box the new asset will be inserted. (Don't worry: you can always reorder this later.)
  9. Click the Save button.

Selecting RSS Feed from the Add/Reorder dropdown

Selecting an asset to reuse

Saving a reused asset


Edit and remove RSS feeds in a guide

  1. To manage an RSS feed, click on the its Edit () icon.
    1. To customize the feed's settings, select  Edit.
      • If this is a mapped asset, please note that this will only apply to this single mapping of the link. It will not affect the original link's description.
    2. To remove the RSS feed from your guide, select  Remove.
      • This will only remove the RSS feed from your guide. It will not delete it from your assets library (Content > Assets) and can still be reused.

Options for editing an RSS feed


Editing RSS feeds in your assets library

The assets library is where all reusable assets are stored in your LibGuides system. From here, you can centrally manage your assets, as well as create new ones.

  • Admin users can edit any asset in the system.
  • Regular users with the Manage Assets permission (CMS only) can also edit any asset.
  • All other Regular and Editor users can only edit the assets they own.

To edit your RSS assets:

  1. Go to Content > Assets.
  2. Use the filters at the top of the page to filter the assets library (such as by type or owner).
  3. To edit an asset, click on its Edit () icon in the Actions column.
    • Changes made to the asset will be reflected everywhere the asset is being used.
    • The only exception is if a mapping of the asset is using a custom description. In that case, the custom description will continue to display on that guide.

Navigating to the Assets page

Filtering the assets list

Clicking an asset's Edit icon

Related Articles

    Nav menu script