Guides/Create content/Widgets/Display an RSS feed

Display an RSS feed

RSS is a term used to describe a machine-readable version of the content of a blog or a website. You can display content from any site’s RSS feed on your website.

Add the RSS block

To display an RSS feed, add the RSS block by clicking on the + block inserter and searching for RSS. Alternatively, you can type /rss on a new line and press enter:

Image showing how to insert an RSS block by typing /rss
Adding a RSS block with the slash command

For more information, visit our detailed instructions on adding blocks.

Add a feed URL to the RSS block

To add an RSS feed, obtain the feed’s URL (i.e. the link). Some websites display an orange icon on their website to share their RSS feed.

It’s also common to add /feed to the end of a blog URL to obtain the RSS feed URL. For example, the WordPress.com blog’s feed URL is https://wordpress.com/blog/feed. The WordPress RSS Feeds guide shares how to find the feed link for a WordPress.com website.

Once you have the feed URL, you can then paste that directly into the RSS block:

Image showing the RSS block interface
The RSS block

Click “Use URL” and the RSS feed will be displayed. Here is an example, showing the latest posts in a list view from the WordPress.com blog:

And the same feed, but in a grid view:

RSS block toolbar

The RSS block toolbar shows the following options:

Image showing the RSS block's toolbar
RSS block toolbar
  • Align the content left, center, or right (also includes wide and full-width options if supported by your theme).
  • Edit the RSS feed URL you inserted.
  • List view to show the content in a list (example above).
  • Grid view to show the content in a grid (example above).
  • Additional block options.

RSS block settings

When you select a block, you will find additional block settings in the right sidebar. If you do not see the sidebar, you may need to click the Settings icon in the top-right corner to bring up the settings. This icon looks like a square with two uneven columns:

An arrow pointing to the "Settings" icon in the top right of the WordPress Editor.
Click the Settings icon to open the block settings

In the RSS block settings in the sidebar, you can choose the number of items that will display from the RSS feed. The maximum number of items is 10. The most recent items will always be shown.

You can also choose to display or hide the author’s name, the date of publication, and the post’s excerpt.

RSS block settings.

RSS shortcode

As an alternative to the RSS block, if your site does not use the WordPress block editor, is to use the RSS shortcode. To use the shortcode, you’ll also need the URL of the feed you want to embed (as described in the previous section).

Once you have the feed link, add it to your post or page by converting it into a shortcode using this format:

[rss url=https://wordpress.com/blog/feed]

You can add this shortcode to any page or post using a shortcode block. The number of items displayed from the RSS feed will be determined by the feed owner.

Customize the RSS shortcode

There are several ways you can customize your feed:

OptionDescriptionChoicesDefault Setting
show_titleDisplay the article title (If titles are hidden, links will be automatically hidden as well.)true, falsetrue
show_linksDisplays the article title as a linktrue, falsetrue
show_summaryDisplays an excerpt of the articletrue, falsetrue
show_authorDisplays the author of the articletrue, falsefalse
show_dateDisplays the date the article was publishedtrue, falsefalse
reverseReverses the order of the listed articlestrue, falsefalse (most recent at top)

RSS shortcode examples

[rss url=https://wordpress.com/blog/feed show_title=false]

RSS example showing two posts in a list.

[rss url=https://wordpress.com/blog/feed show_author=true show_date=true]

RSS example showing two posts in a list with titles, dates, excerpts, and authors.

[rss url=https://wordpress.com/blog/feed show_summary=false]

RSS example showing six post titles.

RSS troubleshooting

If you’re seeing this error with your RSS feed: An error has occurred; the feed is probably down. Try again later., there’s either an error with your feed URL or the feed itself is down. Here are some steps to troubleshoot your RSS feed shortcode:

  • Make sure you include http:// or https:// in your domain name.
  • Do not use quotes.
  • Confirm that your feed URL validates using this feed validator.
  • If your feed URL is PHP, the additional parameters at the end may cause issues. Try removing everything after .php including the question mark.

Was this guide helpful for you?

Not quite what you're looking for? Get Help!

Copied to clipboard!