W
Navigation & Menus Free WordPress.org

WP-PageNavi

4.7 (149 reviews)
· 500K+ active installs · By Lester Chan
Active Installs
500K+
Rating
4.7 / 5
Version
v2.94.5
Last Updated
Dec 2024
Share

Plugin Review

AI-Researched

What is WP-PageNavi?

WP-PageNavi replaces the default "Older posts" and "Newer posts" links with a full set of numbered page links. Instead of clicking through one page at a time, visitors can jump directly to page 5 or 12. The plugin was created by developer Lester Chan and has been actively maintained for 20 years. It currently holds over 500,000 active installs with a 4.7 out of 5 star rating from 149 user reviews.

Eighty-five percent of those ratings are five stars. Only six percent of users gave it a one-star rating. This longevity and user satisfaction make it one of the most trusted pagination solutions in the WordPress ecosystem.

Key Features of WP-PageNavi

  • Numbered Pagination Links: Converts basic previous/next navigation into a full page-number bar for archive and category pages.
  • Multipart Page Support: Works with single posts that are split across multiple pages using the wp_link_pages() function.
  • Custom CSS Override: Copy the plugin's CSS file to your theme directory to preserve styling changes through updates.
  • Filter-Based Class Names: Ten dedicated WordPress filters let developers rename every pagination HTML class for custom frameworks.
  • Secondary Query Compatibility: Functions correctly with custom WP_Query loops, not just the main query.
  • Settings Dashboard: Configuration is managed under WP-Admin > Settings > PageNavi with no coding required.
  • Multilingual Setup Option: Developers can ignore translation strings by passing default options directly to the template tag.
  • PHP 5+ Requirement: The plugin requires PHP 5 or higher, which covers virtually all modern hosting environments as of 2026.

Who Should Use WP-PageNavi?

This plugin suits any WordPress site with multiple archive pages, especially blogs and news sites. A site publishing 50 posts per month will quickly generate 10 or more paginated pages. WP-PageNavi gives readers direct access to older content without endless clicking. The plugin targets users comfortable editing theme template files, as you must replace next_posts_link() and previous_posts_link() with wp_pagenavi().

Beginners can install it and use the default styling immediately. Developers will appreciate the filter system for class name customization. With 500,000 active installs and a 4.7 rating, the plugin has proven reliable for both personal blogs and high-traffic editorial sites. The six percent one-star ratings typically stem from conflicts with custom query_posts() usage, which is a theme issue rather than a plugin bug.

Installation & Setup

Install the plugin from the WordPress repository and activate it. Then locate next_posts_link() and previous_posts_link() in your theme files and replace them with the single line <?php wp_pagenavi(); ?>. The plugin was tested up to WordPress version 6.7.5, and configuration is available under Settings > PageNavi.

Support & Community

Support data for the last two months shows zero open threads and zero resolved threads, with a 0% resolution rate. This number likely reflects the plugin's stability rather than neglect. After 20 years of development, version 2.94.5 includes few bugs requiring intervention. The WordPress.org forum has 149 ratings, with 85% five-star reviews indicating that most users install it and never need to ask for help.

The six percent one-star ratings often cite the activation error requiring PHP 5, which is a non-issue for virtually all hosts in 2026. The developer provides a documented FAQ addressing common mistakes like improper query_posts() usage. For users who need custom class names, the ten available filters offer a supported path to modification without hacking core files.

Pros & Cons

What's Good
  • Over 500,000 active installs and a 4.7/5 rating from 149 reviews indicate widespread trust and satisfaction.
  • Replaces default 'Older posts' and 'Newer posts' links with numbered page navigation, improving user browsing on archive pages.
  • Provides a dedicated settings page under WP-Admin for easy configuration of pagination display without editing theme files.
  • Offers 10 filter hooks (e.g., wp_pagenavi_class_page) to customize CSS class names, allowing advanced theming without modifying plugin core.
  • Supports both standard post lists and multipart page navigation via the 'type' => 'multipart' parameter, covering two common use cases.
Drawbacks
  • Requires manual theme edits to replace next_posts_link() and previous_posts_link() calls, which may break if theme code is updated.
  • Only 149 total ratings suggest limited community feedback compared to plugins with thousands of reviews, making long-term reliability less certain.
  • No support threads exist (0 total, 0 resolved), meaning users cannot get help through the official WordPress plugin support forum.
  • The plugin's CSS file must be manually copied to the theme directory to preserve custom styles during plugin updates, adding maintenance overhead.

Technical Details

Requires WordPress
4.6+
Tested up to WP
6.7.5
First Released
2006 (20+ years)
Support (last 2 months)
0 threads

Feature Tags

navigation pages pagination paging

Frequently Asked Questions