Top 10 is a post views counter and popular posts plugin for WordPress. It counts daily and total page views on posts, pages and custom post types, then displays your most viewed and trending posts with blocks, widgets and shortcodes. All data stays in your WordPress database, with no cookies and no personal data.
WordPress.org · Plugin page · Documentation · Top 10 Pro
- Daily and total view counts, tracked in the background so page caches don't block counting
- Popular posts lists by total views or a custom period
- Popular Posts and Post Count blocks, widgets, and the
[tptn_list]and[tptn_views]shortcodes - Admin dashboard with a views chart, view-count columns, and a multisite network dashboard
- Koko Analytics as an optional data source
- Import and export of counts and settings, and migration from WordPress Popular Posts
- REST API, Abilities API, and extensive actions and filters
- Works with WPML, Polylang and TranslatePress
See the full feature list on WordPress.org and the Free vs Pro comparison.
- WordPress admin: Go to Plugins → Add New, search for "Top 10", then install and activate it.
- WP-CLI:
wp plugin install top-10 --activate - Zip: Download a release from GitHub Releases and upload it under Plugins → Add New → Upload Plugin.
Then configure the plugin under Top 10 → Settings.
This repository holds the latest development version. Stable releases are published on WordPress.org.
Requirements: WordPress 6.8+, PHP 7.4+, Composer and pnpm.
composer install
pnpm install
pnpm run build # Build the blocks
pnpm run build:assets # Minify CSS and JS, and generate RTL CSS
composer test # PHPCS, PHP compatibility and PHPStan
composer phpcbf # Fix coding standardsPHPUnit tests live in phpunit/tests/ and need the WordPress test suite, installed with phpunit/install.sh. Architecture notes are in CLAUDE.md.
Pull requests for bug fixes and improvements are welcome. Follow the WordPress coding standards and run composer test before submitting. Please use the WordPress.org support forum for support questions, not GitHub issues.
Help translate Top 10 on translate.wordpress.org.
Report security vulnerabilities through the Patchstack Vulnerability Disclosure Program. See security.md.
See the changelog in readme.txt and the releases page.
Top 10 is licensed under the GNU General Public License v2 or later.
