RSS block

Go back to the list of Blocks

An RSS feed is a machine-readable version of the content of a blog or a website.

With the RSS block, you can display content from any site’s RSS feed on your website. You can choose to display the Title, Author, Date, and Excerpt for each item in the feed. You can display the items in a list or as a grid in a set number of columns.

Steps to embed an RSS block

  1. First, you need to know the URL of the RSS feed that you want to embed. Some websites display an orange icon with the link of the feed. You can usually find this icon together with social network icons.
    Our example uses the feed of the News section on WordPress.org.  https://wordpress.org/news/feed
  1. Click the Block Inserter (+) icon to add an RSS block to your WordPress page/post. Alternatively, you can type /rss and hit enter in a new paragraph block to add one quickly.
Adding RSS block via the WordPress slash command /rss

Detailed instructions on adding blocks

  1. Paste the link of the RSS feed into the text box and click on the Use URL button
Enter URL here user interface for the RSS block.

The RSS block now displays the titles of the feed items. 

Display of the RSS feed.

If you use an URL that can’t be embedded, the block shows the message “RSS Error: WP HTTP Error: A valid URL was not provided.”.

Example of a URL that cannot be used in the RSS block.

Use the options in the Block Toolbar and the controls in the Block Settings panel in your editor’s sidebar to fine-tune the display.

Block Toolbar

Besides the Mover and Drag & Drop handle, the Block Toolbar for the RSS block shows six other buttons:

  • Transform To
  • Change alignment
  • Edit RSS URL
  • List view
  • Grid view
  • More options
Block toolbar for the RSS block.

Transform to

You can transform the RSS block into Columns or a Group. Transforming to a group would give you the ability to change the background color around the embed.

Transform options for the RSS block.

Change alignment

  • Align left – Make the block left-aligned.
  • Align center – Make the block alignment centered.
  • Align right – Make the block right-aligned.
  • Wide width – Increase the width of the block beyond the content size.
  • Full width – Extend the block to cover the full width of the screen.
Change alignment options for RSS block.

The “Wide width” and “Full width” alignment settings must be enabled by your WordPress theme. 

Edit RSS URL

Via the edit URL, you can change the RSS feed URL in the block. Overwrite the existing URL and click on the Use URL button.

Edit RSS Feed URL in the block.

List view

The List view option displays the feed items in an unordered list. Use the Block settings controls to customize the List view.

List view for the RSS block.

Grid view

Display the feed items in a grid. Use the Block settings controls to adjust the number of columns and the other display options. 

Grid view for the RSS block.

More options

These controls give you the option to copy, duplicate, and edit your block as HTML.

Detailed instructions on adding blocks

Block Settings

Every block has specific options in the editor sidebar in addition to the options found in the block toolbar. If you do not see the sidebar, simply click the ‘cog’ icon.

Cog icon to display the Block sidebar
Block settings for the RSS block.

Settings

Number of items: Slider and number box to adjust the number of feed items you’d like to display. To change the number move the dot on the slider or update the number in the box next to it.

Display author: Switch on/off the display of the author’s name 

Display date: Switch on/off the display of the published date of the feed items

Display excerpt: Switch on/off the display of an excerpt from the feed items’ content. 

Max number of words in excerpt: Slider and number box to choose the maximum number of words that can be displayed in the excerpt. The minimum number is 10. This section is not visible if Display excerpt is in the OFF position. 

Columns: Slider and number box to control the number of columns for the grid view. This option is only visible when you select the Grid view on the Block Toolbar.

Advanced

The advanced tab lets you add a CSS class to your block, allowing you to write custom CSS and style the block as you see fit.

Advanced option in the selected Block
Advanced option in the selected Block

Resources

Changelog

  • Updated 2022-11-20
    • Aligned images for mobile view
    • Removed redundant content
    • Added heading
  • Updated 2022-11-08
    • Updated “RSS Settings” screenshot
  • Updated 2022-09-28
    • Fixed font sizing under “Block Settings”
  • Updated 2022-09-12
    • Video walkthrough created
    • Updated with images from WordPress 6.0
    • Added new “Transform to” setting (Column)
    • Added “Lock” information under More Options
    • Added ALT tags for the images
  • Updated 2022-02-08
    • Update screenshots for 5.9
  • Updated 2020-08-17
    • Converted More Options reusable block to regular blocks
  • Updated 2020-04-28
    • changed category to “Widget Blocks”
    • changed dates in Changelog to universal format
  • Updated 2020-04-18
    • Converted reusable block to regular blocks
    • Added to “Core Blocks” category
  • Updated: 2019-11-25
    • change the first sentence and
    • aligned images to the right of the text where it adds to readability
  • Created: 2019-11-23 / WordPress 5.3

Was this article helpful? How could it be improved?

First published

Last updated