How to set up a feed of WordPress.org forum reviews, available on the Elite licence and the All Access Bundle.
Would you like to show the WordPress.org reviews of a plugin or theme on your website?
In this guide, we’ll walk you through adding a plugin or theme’s WordPress.org page as a source and building a feed to show its reviews. All you need is Reviews Feed and the URL of the plugin or theme’s page on WordPress.org.
Requirements: WordPress.org is available on the Elite license level of Reviews Feed.
Before you get started, make sure Reviews Feed is installed and activated on your WordPress site.
- Connecting WordPress.org as a Review Source
- Building Your WordPress.org Feed
- Embedding Your Feed
- Frequently Asked Questions
Connecting WordPress.org as a Review Source
To get started, we’ll copy the URL of the plugin or theme’s page on WordPress.org and add it as a source.
You don’t need a WordPress.org account or an API key. Reviews Feed only needs the URL of the plugin or theme’s page.
To find it, open the plugin or theme on WordPress.org and copy the address from your browser’s address bar. A plugin’s address contains /plugins/, like https://wordpress.org/plugins/instagram-feed/. A theme’s address contains /themes/, like https://wordpress.org/themes/twentytwentythree/.
Once you have the URL, go to Reviews Feed » All Feeds in your WordPress admin sidebar.
At the top of the All Feeds page, click Add New.

This opens the Create a Review feed screen. Its first step is where you choose the sources your feed shows.
Since you haven’t added a source yet, click Add Source.

Note: If you’ve already added other sources, the Add New tile on this step opens the same window.
The Add Sources window opens with a tile for each review source. To add your plugin or theme, click the WordPress.org tile.

Once you’ve chosen the tile, click Next at the bottom of the window.

On the Add Source Details step, Reviews Feed asks for your page URL. It uses this address to know which page to fetch reviews from.
The address must contain /plugins/ or /themes/. That means you need the plugin or theme’s main page, not its reviews page in the WordPress.org support forums. The support forum’s reviews page has /plugin/ in its address, not /plugins/.
If the address doesn’t contain either one, Reviews Feed shows a reminder when you try to finish, with an example of each. In that case, replace it with the plugin or theme’s page URL.

Next, paste the plugin or theme’s page URL into the Page URL field. When you’re done, click Finish.

Reviews Feed adds your source and shows a Source added successfully message.
Now that WordPress.org is connected as a source, you’re ready to build your feed.
Building Your WordPress.org Feed
Your new source now shows on the Add Source step, named after the plugin or theme. Since a feed can show more than one source, you can add and select others here too.
If your new source isn’t selected yet, select it. When your sources are selected, click Next at the top of the screen.

Next, choose a template for your feed. A template sets the layout for your reviews. If you’re not sure which to pick, keep Default, which is selected to start with.
You can change your template later in the feed editor. Because a new template can replace customizations you’ve made, it’s easiest to choose one now.
Once you’ve picked a template, click Next.

Reviews Feed creates your feed and opens it in the feed editor. The preview on the right shows the plugin or theme’s WordPress.org reviews.
While you’re in the editor, use the Customize tab to change your feed’s template, layout, header, reviews, and Load More button. Our guide on customizing the look of your reviews feed walks you through each section.
When you’re happy with how your feed looks, click Save.

Your WordPress.org feed is now saved. Next, we’ll look at how to display it.
Embedding Your Feed
Your feed is ready to add to your site. You can add it with the Reviews Feed block in the block editor or with its shortcode.
To copy your feed’s shortcode or add it to a page, click Embed at the top of the feed editor.

The Embed Feed window opens with your feed’s shortcode and a Copy button. The shortcode looks like [reviews-feed feed="1"]. The number is your feed’s ID.
If you’re new to shortcodes, see How to Add a Shortcode in WordPress for a step-by-step guide.
The window also has a Post or a Page option that adds your feed to a page for you.
Once your feed is on a page, each review shows the WordPress.org logo. The logo tells your visitors where each review comes from.

For every way to show your feed, see our guide on displaying your reviews feed.
That’s it! You’ve connected a plugin or theme’s WordPress.org page and built a feed of its reviews.
Next, would you like to choose which reviews your feed shows? See our guide on filtering reviews by rating, keyword, or source.
Frequently Asked Questions
Below, we’ve answered some of the most common questions about showing WordPress.org reviews.
Do I need a WordPress.org account or an API key?
No. Reviews Feed only needs the URL of the plugin or theme’s page on WordPress.org.
For where to find it, see the Connecting WordPress.org as a Review Source section above.
Which WordPress.org URL should I use?
The right URL is the address of the plugin or theme’s main page on WordPress.org. A plugin’s address contains /plugins/, like https://wordpress.org/plugins/instagram-feed/. A theme’s address contains /themes/, like https://wordpress.org/themes/twentytwentythree/. If the address contains neither, like the reviews page in the support forums, Reviews Feed shows a reminder with an example of each.
What happens when my site reaches its WordPress.org source limit?
Each site can add a limited number of WordPress.org sources. Once your site reaches that limit, clicking Finish shows a Source Limit Exceeded message and takes you back to the source tiles. A notice there says your site has reached the allowed number of WordPress.org sources.
What if I see “Could not add source” after I click Finish?
Reviews Feed shows this general message when a source can’t be added and no other message is available. It mentions an API key, which WordPress.org doesn’t need. First, check that your Page URL is the plugin or theme’s main page, like https://wordpress.org/plugins/instagram-feed/. Then try adding your source again.
Why don’t my WordPress.org reviews show the WordPress.org logo?
Reviews Feed 2.13.0 fixed the WordPress.org logo on WordPress.org reviews. If the logo is missing on your site, update Reviews Feed to the latest version.
Can I show WordPress.org reviews alongside other sources?
Yes. On the Add Source step, you can select more than one source for the same feed. This means you can combine WordPress.org with Google, Trustpilot, or any other source you’ve added.