WordPress Popular Posts


WordPress Popular Posts is a highly customizable widget that displays your most popular posts.

Main Features

  • Multi-widget capable – You can have several widgets of WordPress Popular Posts on your blog, each with its own settings!
  • Time Range – List those posts of your blog that have been the most popular ones within a specific time range (eg. last 24 hours, last 7 days, last 30 days, etc)!
  • Custom Post-type support – Wanna show other stuff than just posts and pages?
  • Thumbnails! – Display a thumbnail of your posts! (see the FAQ section for technical requirements.)
  • Statistics dashboard – See how your popular posts are doing directly from your admin area.
  • Sorting options – Order your popular list by comments, views (default) or average views per day!
  • Use your own layout! – WPP is flexible enough to let you customize the look and feel of your popular posts! (see customizing WPP’s HTML markup and How to style WordPress Popular Posts for more.)
  • Advanced caching features! – WordPress Popular Posts includes a few options to make sure your site’s performance stays as good as ever! (see Performance for more details.)
  • REST API Support – Embed your popular posts in your (web) app! (see REST API Endpoints for more.)
  • Disqus support – Sort your popular posts by Disqus comments count!
  • Polylang & WPML 3.2+ support – Show the translated version of your popular posts!
  • WordPress Multisite support – Each site on the network can have its own popular posts!

Other Features

  • Shortcode support – Use the [wpp] shortcode to showcase your most popular posts on pages, too! For usage and instructions, please refer to the installation section.
  • Template tags – Don’t feel like using widgets? No problem! You can still embed your most popular entries on your theme using the wpp_get_mostpopular() template tag. Additionally, the wpp_get_views() template tag allows you to retrieve the views count for a particular post. For usage and instructions, please refer to the installation section.
  • Localization – Translate WPP to your own language (See the FAQ section for more info).
  • WP-PostRatings support – Show your visitors how your readers are rating your posts!

WordPress Popular Posts is now also on GitHub!

Looking for a Recent Posts widget just as featured-packed as WordPress Popular Posts? Try Recently!


  • Flame graphic by freevector/Vecteezy.com.


  • Widgets Control Panel.
  • WordPress Popular Posts Widget.
  • WordPress Popular Posts Widget on theme's sidebar.
  • WordPress Popular Posts Stats panel.


Please make sure your site meets the minimum requirements before proceeding.

Automatic installation

  1. Log in into your WordPress dashboard.
  2. Go to Plugins > Add New.
  3. In the “Search Plugins” field, type in WordPress Popular Posts and hit Enter.
  4. Find the plugin in the search results list and click on the “Install Now” button.

Manual installation

  1. Download the plugin and extract its contents.
  2. Upload the wordpress-popular-posts folder to the /wp-content/plugins/ directory.
  3. Activate the WordPress Popular Posts plugin through the “Plugins” menu in WordPress.

Done! What’s next?

  1. Go to Appearance > Widgets, drag and drop the WordPress Popular Posts widget to your sidebar. Once you’re done configuring it, hit the Save button.
  2. If you have a caching plugin installed on your site, flush its cache now so WPP can start tracking your site.
  3. If you have a security / firewall plugin installed on your site, make sure you allow WPP access to the REST API so it can start tracking your site.
  4. Go to Appearance > Editor. Under “Templates”, click on header.php and make sure that the <?php wp_head(); ?> tag is present (should be right before the closing </head> tag).
  5. (Optional, but highly recommended for large / high traffic sites) Enabling Caching and/or Data Sampling might be a good idea if you’re worried about performance. Check here for more.

That’s it!


WordPress Popular Posts can be used in three different ways:

  1. As a widget: simply drag and drop it into your theme’s sidebar and configure it.
  2. As a template tag: you can place it anywhere on your theme with wpp_get_mostpopular().
  3. Via shortcode, so you can embed it inside a post or a page.

Make sure to stop by the Wiki as well, you’ll find even more info there!


The FAQ section has been moved here.


Rampant server problems

Unfortunately, I can’t recommend this plugin, though it has nice features. I have had major issues with this plugin causing CPU spikes, leading to database outages, and bringing my entire server cluster to a halt. I can fix it by killing rogue php-fpm processes, sometimes restarting apache, but the problems always come back. My server CPUs now run nice and cool at around 1% load, where they never ran below 50% with this plugin active. Having it on post sidebar killed my site completely, having it on homepage sidebar only still caused heavy CPU load. I am sure it’s a conflict with something else as my theme is custom, but who has time to chase these kinds of ghosts? Sorry – moving on.

Read all 180 reviews

Contributors & Developers

“WordPress Popular Posts” is open source software. The following people have contributed to this plugin.


“WordPress Popular Posts” has been translated into 6 locales. Thank you to the translators for their contributions.

Translate “WordPress Popular Posts” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



If you’re using a caching plugin, flushing its cache right after installing / upgrading to this version is required.

  • Breaking change: Database query performance improvements (thanks Stofa!), plugin should be significantly faster for most people out there. Developers: if you’re hooking into the WPP_Query class to customize the query, you will have to review it as this change will likely break your custom query.
  • Persistent object caching support: WPP can now store views count in-memory, reducing greatly the number of database writes which is good for performance!
  • Adds filter hook wpp_parse_custom_content_tags.
  • Adds filter hook wpp_taxonomy_separator.
  • You can now also pass arrays when using the parameters post_type, cat, term_id, pid or author (see issue 169 for details).
  • The plugin will use language packs from wordpress.org from now on.
  • Minor fixes and improvements.

Check the Release notes for more details!


  • Enables Data Caching by default (new installs only).
  • The Parameters section (Settings > WordPress Popular Posts > Parameters) is now mobile-friendly.
  • Updated the documentation in the Parameters section.
  • Refactored WPP’s caching mechanism into its own class.
  • Removed unused code.


If you’re using a caching plugin, flushing its cache right after installing / upgrading to this version is highly recommended.

  • Improves compatibility with Cloudflare’s Rocket Loader.
  • Code cleanup.
  • Fixes a minor bug (plugin returning the wrong excerpt when a translation plugin is used).
  • Bumps minimum required PHP version to 5.3.

See full changelog.