WordPress Popular Posts


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

Main Features

  • Multi-widget capable. That is, 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?
  • Display a thumbnail of your posts! (see the FAQ section for technical requirements).
  • 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 styling the list for more).
  • WPML support!
  • WordPress Multisite support!

Other Features

  • Check the statistics on your most popular posts from the dashboard.
  • Order your popular list by comments, views (default) or average views per day!
  • 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.
  • Localizable 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!


  • 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. 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).
  4. (Optional, but highly recommended for large / high traffic sites) Enabling Data Sampling and/or Caching might be a good idea. 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.


Useful plugin

After 2 month of usage i can say that it is useful plugin to display the popular posts. i can give my rating as 5 stars.

totally satisfied

I want to have the program that will help me to control what and how I show to my visitors. I really happy how it’s easy to use and the plenty of options that it offers. “WordPress Popular Posts” undoubtedly deserves 5 stars!

Great Popular Post Plugin

If you are looking for a Popular Post Plugin, look no further.

It is simple to use and you have big control over how it will behave and what will be displayed. I especially like the ability to customize HTML for each element.

Lees alle 154 beoordelingen

Bijdragers & ontwikkelaars

“WordPress Popular Posts” is open source software. De volgende personen hebben bijgedragen aan deze plugin.


“WordPress Popular Posts” is vertaald in 4 talen: Japanese, Spanish, Dutch, English (UK). Dank voor de vertalers voor hun bijdragen.

Vertaal “WordPress Popular Posts” naar jouw taal.

Interested in development?

Browse the code or subscribe to the development log by RSS.



  • Attempt to convert tables to InnoDB during upgrade if other engine is being used.
  • Adds a check to prevent the upgrade process from running too many times.
  • Minor improvements and bug fixes.
  • Documentation updated.


  • Fixes potential XSS exploit in WPP’s admin dashboard.
  • Adds filter to set which post types should be tracked by WPP (details).
  • Adds ability to select first attached image as thumbnail source (thanks, @serglopatin!)


  • Fixes warning message: ‘stream does not support seeking in…’
  • Removes excerpt HTML encoding.
  • Passes widget ID to the instance variable for customization.
  • Adds CSS class current.
  • Documentation cleanup.
  • Other minor bug fixes / improvements.


  • Fixes undefined index notice.
  • Makes sure legacy tables are deleted on plugin upgrade.


  • Adds the ability to limit the amount of data logged by WPP (see Settings > WordPress Popular Posts > Tools for more).
  • Adds Polylang support (thanks, @Chouby!)
  • Removes post data from DB on deletion.
  • Fixes whitespaces from post_type argument (thanks, @getdave!)
  • WPP now handles SSL detection for images.
  • Removes legacy datacache and datacache_backup tables.
  • Adds Settings page advertisement support.
  • FAQ section has been moved over to Github.


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

  • Fixes a potential bug that might affect other plugins & themes (thanks @pippinsplugins).
  • Defines INNODB as default storage engine.
  • Adds the wpp-no-data CSS class to style the “Sorry, no data so far” message.
  • Adds a new index to summary table.
  • Updates plugin’s documentation.
  • Other small bug fixes and improvements.


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

  • Moves sampling logic into Javascript (thanks, @kurtpayne!)
  • Simplifies category filtering logic.
  • Fixes list sorting issue that some users were experimenting (thanks, sponker!)
  • Widget uses stock thumbnails when using predefined size (some conditions apply).
  • Adds the ability to enable / disable responsive support for thumbails.
  • Renames wpp_update_views action hook to wpp_post_update_views, update your code!
  • Adds wpp_pre_update_views action hook.
  • Adds filter wpp_render_image.
  • Drops support for get_mostpopular() template tag.
  • Fixes empty HTML tags (thumbnail, stats).
  • Removes Japanese, French and Norwegian Bokmal translation files from plugin.
  • Many minor bug fixes / enhancements.

See full changelog.