Title: WP-Paginate Author: maxfoundry Published: September 4, 2009 Last modified: February 19, 2025 --- Search plugins ![](https://ps.w.org/wp-paginate/assets/banner-772x250.png?rev=1569492) ![](https://ps.w.org/wp-paginate/assets/icon-128x128.png?rev=1566512) # WP-Paginate By [maxfoundry](https://profiles.wordpress.org/maxfoundry/) [Download](https://downloads.wordpress.org/plugin/wp-paginate.2.2.4.zip) * [Details](https://wordpress.org/plugins/wp-paginate/#description) * [Reviews](https://wordpress.org/plugins/wp-paginate/#reviews) * [Installation](https://wordpress.org/plugins/wp-paginate/#installation) * [Development](https://wordpress.org/plugins/wp-paginate/#developers) [Support](https://wordpress.org/support/plugin/wp-paginate/) ## Description #### Latest News WP-Paginate is a simple and flexible pagination plugin which provides users with better navigation on your WordPress site. In addition to increasing the user experience for your visitors, it has also been widely reported that pagination increases the SEO of your site by providing more links to your content. You can add custom CSS for your pagination links with the Custom CSS tab in WP-Paginate Settings. Starting in version 1.1, WP-Paginate can also be used to paginate post comments! Translations: https://plugins.svn.wordpress.org/wp-paginate/I18n (check the version number for the correct file) ## Screenshots * [[ * [[ ## Installation _Install and Activate_ 1. Unzip the downloaded WP-Paginate zip file 2. Upload the `wp-paginate` folder and its contents into the `wp-content/plugins/` directory of your WordPress installation 3. Activate WP-Paginate from Plugins page _Implement_ You can now configure the location and appearance of pagination links through WP- Paginate Settings rather than edit your theme files. See the Configure section. For posts pagination: * Open the theme files where you’d like pagination to be used. Depending on your theme, this could be in a number of files, such as `index. php`, `archive.php`, `categories.php`, `search.php`, `tag.php`, or the `functions. php` file(s).The `twentyeleven` theme places the pagination code in `functions.php` in the `twentyeleven_content_nav()` function. Examples: For the `Twenty Seventeen` theme, in `index.php`, replace: ``` the_posts_pagination( array( 'prev_text' => twentyseventeen_get_svg( array( 'icon' => 'arrow-left' ) ) . '' . __( 'Previous page', 'twentyseventeen' ) . '', 'next_text' => '' . __( 'Next page', 'twentyseventeen' ) . '' . twentyseventeen_get_svg( array( 'icon' => 'arrow-right' ) ), 'before_page_number' => '' . __( 'Page', 'twentyseventeen' ) . ' ', ) ); ``` With: ``` if(function_exists('wp_paginate')): wp_paginate(); else : the_posts_pagination( array( 'prev_text' => twentyseventeen_get_svg( array( 'icon' => 'arrow-left' ) ) . '' . __( 'Previous page', 'twentyseventeen' ) . '', 'next_text' => '' . __( 'Next page', 'twentyseventeen' ) . '' . twentyseventeen_get_svg( array( 'icon' => 'arrow-right' ) ), 'before_page_number' => '' . __( 'Page', 'twentyseventeen' ) . ' ', ) ); endif; ``` For the `Twenty Sixteen` theme, in `index.php`, replace: ``` the_posts_pagination( array( 'prev_text' => __( 'Previous page', 'twentysixteen' ), 'next_text' => __( 'Next page', 'twentysixteen' ), 'before_page_number' => '' . __( 'Page', 'twentysixteen' ) . ' ', ) ); ``` With: ``` if(function_exists('wp_paginate')): wp_paginate(); else : the_posts_pagination( array( 'prev_text' => __( 'Previous page', 'twentysixteen' ), 'next_text' => __( 'Next page', 'twentysixteen' ), 'before_page_number' => '' . __( 'Page', 'twentysixteen' ) . ' ', ) ); endif; ``` For the `Twenty Fifteen` theme, in `index.php`, replace: ``` the_posts_pagination( array( 'prev_text' => __( 'Previous page', 'twentyfifteen' ), 'next_text' => __( 'Next page', 'twentyfifteen' ), 'before_page_number' => '' . __( 'Page', 'twentyfifteen' ) . ' ', ) ); ``` With: ``` if(function_exists('wp_paginate')): wp_paginate(); else : the_posts_pagination( array( 'prev_text' => __( 'Previous page', 'twentyfifteen' ), 'next_text' => __( 'Next page', 'twentyfifteen' ), 'before_page_number' => '' . __( 'Page', 'twentyfifteen' ) . ' ', ) ); endif; ``` For comments pagination: 1) Open the theme file(s) where you’d like comments pagination to be used. Usually this is the `comments.php` file. 2) Replace your existing `previous_comments_link()` and `next_comments_link()` code block with the following: ``` ``` _Configure_ 1) Configure the WP-Paginate settings, if necessary, from the WP-Paginate option in the Settings menu 2) The styles can be changed with the following methods: * Add a `wp-paginate.css` file in your theme’s directory and place your custom CSS there * Add your custom CSS to your theme’s `styles.css` * Modify the `wp-paginate.css` file in the wp-paginate plugin directory _Note:_ The first two options will ensure that WP-Paginate updates will not overwrite your custom styles. _Upgrading_ To 1.1.1+: * Update WP-Paginate settings, change `Before Markup` to `
` * Update `wp-paginate.css`, change `.wp-paginate ol` to `.wp-paginate` ## FAQ ### How can I override the default pagination settings? The `wp_paginate()` and `wp_paginate_comments()` functions each takes one optional argument, in query string format, which allows you to override the global settings. The available options are: * title – The text/HTML to display before the pagination links * nextpage – The text/HTML to use for the next page link * previouspage – The text/HTML to use for the previous page link * before – The text/HTML to add before the pagination links and title * after – The text/HTML to add after the pagination links * empty – Display before markup and after markup code even when the page list is empty * range – The number of page links to show before and after the current page * anchor – The number of links to always show at beginning and end of pagination * gap – The minimum number of pages before a gap is replaced with an ellipsis (…) You can even control the current page and number of pages with: * page – The current page. This function will automatically determine the value * pages – The total number of pages. This function will automatically determine the value Example (also applies to `wp_paginate_comments()`): ``` ``` ### How can I style the comments pagination differently than the posts pagination? When calling `wp_paginate_comments()`, WP-Paginate adds an extra class to the `ol` element, `wp-paginate-comments`. ## Reviews ![](https://secure.gravatar.com/avatar/6002897079381a62d54aea50fe538ef4ec73e1eb451cd88195fd42d08c17d1c1? s=60&d=retro&r=g) ### 󠀁[WP-Paginate](https://wordpress.org/support/topic/wp-paginate-12/)󠁿 [amlakmahkar](https://profiles.wordpress.org/amlakmahkar/) September 22, 2025 افزونه خیلی خوب است. ممنون ![](https://secure.gravatar.com/avatar/c1b8903bc70a5ce9d477382bb50d8aae0863a55a2d8443727ff9ff3371e103a6? s=60&d=retro&r=g) ### 󠀁[Works perfectly](https://wordpress.org/support/topic/works-perfectly-2871/)󠁿 [markbarrettca](https://profiles.wordpress.org/markbarrettca/) July 25, 2025 Excellent plugin for controlling pagination. Very customizable. Responsive. Excellect CSS control. Had one issue trying to get symetric sizes for pages number links ( ex: page 1 and 20 were not the same width). Asked the question in the support forum and got a quick response with excellent results. I’m using Page Range: 2, Page Anchors: 1 Page Gap: 1 and I cleared the Previous page and next page labels in setting. Looks great even on mobile devices. ![](https://secure.gravatar.com/avatar/6dbefa8e939b25b17cb126d700db405bc473df8954e2049323eda56dcd6ced99? s=60&d=retro&r=g) ### 󠀁[Очень хороший плагин!](https://wordpress.org/support/topic/%d0%be%d1%87%d0%b5%d0%bd%d1%8c-%d1%85%d0%be%d1%80%d0%be%d1%88%d0%b8%d0%b9-%d0%bf%d0%bb%d0%b0%d0%b3%d0%b8%d0%bd-31/)󠁿 [alexandr038](https://profiles.wordpress.org/alexandr038/) July 21, 2025 WP-Paginate я пользуюсь впервые. Но мне сразу понравилось удобство и лёгкость настроек этого плагина. И ещё этот плагин адаптивен ко всем размерам экрана. ![](https://secure.gravatar.com/avatar/51f418faa710c765a4a0c92eacfa9adc3613e12c3349b497178da0985641dccb? s=60&d=retro&r=g) ### 󠀁[the best one](https://wordpress.org/support/topic/the-best-one-128/)󠁿 [ruslancho](https://profiles.wordpress.org/ruslancho/) June 29, 2024 thank you! its a great plugin. with CSS styles – this is the winner plugin 🙂 ![](https://secure.gravatar.com/avatar/cd6d1f6c8d82236e791994e445623afb57767383e1f12f33b9ba1e05f84f1aaa? s=60&d=retro&r=g) ### 󠀁[Works great](https://wordpress.org/support/topic/works-great-9246/)󠁿 [happynaturaldog](https://profiles.wordpress.org/happynaturaldog/) May 17, 2024 Added this to my blog and it looks great ![](https://secure.gravatar.com/avatar/3a08b320cdc5465069dd9d0215c612b1c311a0e84fd1d1b9a271b09fef131148? s=60&d=retro&r=g) ### 󠀁[Quick and easy](https://wordpress.org/support/topic/quick-and-easy-355/)󠁿 [Navone Juan](https://profiles.wordpress.org/navone-juan/) December 20, 2023 The plugin works correctly, is very easy to configure and supports many themes.It does not have a Spanish translation at the moment, but it does not affect the front interface [ Read all 107 reviews ](https://wordpress.org/support/plugin/wp-paginate/reviews/) ## Contributors & Developers “WP-Paginate” is open source software. The following people have contributed to this plugin. Contributors * [ maxfoundry ](https://profiles.wordpress.org/maxfoundry/) * [ Eric ](https://profiles.wordpress.org/emartin24/) * [ AlanP57 ](https://profiles.wordpress.org/alanp57/) “WP-Paginate” has been translated into 2 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/wp-paginate/contributors) for their contributions. [Translate “WP-Paginate” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-paginate) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/wp-paginate/), check out the [SVN repository](https://plugins.svn.wordpress.org/wp-paginate/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-paginate/) by [RSS](https://plugins.trac.wordpress.org/log/wp-paginate/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.2.4 * Added class ‘ellipse-gap’ to the pagination HTML #### 2.2.3 * Tested with WordPress 6.7 * Fixed issue with calling _load_textdomain_just_in_time function #### 2.2.2 * Tested with WordPress 6.5 #### 2.2.1 * Tested with WordPress 6.4 #### 2.2.0 * Tested with WordPress 6.1 #### 2.1.9 * Added code to prevent script injection into a hidden field on the settings page #### 2.1.8 * Add the < nav> tag to the list of allowed tags for pagination markup #### 2.1.7 * Tested with WordPress 5.8 #### 2.1.6 * Improved accessibility by adding aria-label attributes #### 2.1.5 * Updated jQuery function calls * Replaced old color picker with newer version #### 2.1.4 * Fixed potential XSS Vulnerabilities #### 2.1.3 * Tested with WordPress 5.6 * Updated readme.txt with note to use WP-Paginate Settings rather than editing theme files * Added Portuguese translation #### 2.1.2 * Added code to fix PHP warning message #### 2.1.1 * Added setting to remove ellipses from pagination links * Added code to load jquery-migrate #### 2.1.0 * Tested with WordPress 5.5 #### 2.0.9 * Fix inserting of empty style tag #### 2.0.8 * Tested with WordPress 5.4.1 #### 2.0.7 * Fixed issue with not applying before and after function arguments #### 2.0.6 * Fixed issue with slashes added to URLs containing query strings #### 2.0.5 * Added option to add trailing slash to pagination links when needed #### 2.0.4 * Removed trailing slash from pagination links #### 2.0.3 * Added neon pink button style #### 2.0.2 * Added new preset * Updated setting page screen shots #### 2.0.1 * fixed undefined index notices #### 2.0.0 * Added new button styles * Added the ability to select the font * Updated the translation file * Added the ability to add pagination without editing theme files. This applies to posts but not to comments. * Added the ability to hide the standard theme pagination. This applies to posts but not to comments. * Added a review notice = 1.3.4= * Tested with WordPress 4.7.1 #### 1.3.3 * Added settings tab for entering custom CSS code #### 1.3.2 * Tested with WordPress 4.7 #### 1.3.1 * Fixed bug that prevented a wp-paginate.css stylesheet from loading from a child theme (reported by sunamumaya) * Tested plugin against WordPress 4.1 #### 1.3 * Plugin ownership transfered to Studio Fuel (http://studiofuel.com) – no functional changes were made * Tested plugin against WordPress 4.0.1 #### 1.2.6 * Removed final closing PHP tag Github pull request via DeanMarkTaylor * Do not add the title element if the title is empty Github pull request via Claymm/ chaika-design #### 1.2.5 * Remove PHP4 support to resolve PHP Strict warning Github pull request via DeanMarkTaylor * Test with latest version of WordPress #### 1.2.4 * Ensure pagination of posts when wp_paginate() is called Github pull request via whacao * Support loading on https pages (plugin now requires WordPress 2.6+) Github pull request via hadvig #### 1.2.3 * Fixed deprecated parameter to the WordPress add_options_page() function Github pull request via alexwybraniec #### 1.2.2 * Fixed a XSS vulnerability reported by Andreas Schobel (@aschobel) #### 1.2.1 * Added is_rtl function check to prevent errors with older version of WordPress #### 1.2 * Added RTL language support * Fixed comments pagination bug * Changed language domain name from wp_paginate to wp-paginate (this will affect translation file names) #### 1.1.2 * Fixed comment pagination bug (nested comments caused blank page) * Enabled HTML for Pagination Label, Previous Page, and Next Page * Localization changes were made, Translations need to be updated #### 1.1.1 * Changed output to include `wp-paginate` and `wp-paginate-comments` class names on the `ol` element * Changed the `before` option from `
` to `
` * Added `.wp-paginate-comments` styles to `wp-paginate.css` * Changed styles in `wp-paginate.css` #### 1.1 * Added `wp_paginate_comments()` function for pagination of post comments #### 1.0.1 * Added I18n folder and wp-paginate.pot file * Fixed some internationalization and spelling errors * Updated readme.txt and added more details #### 1.0 * Initial release ## Meta * Version **2.2.4** * Last updated **1 year ago** * Active installations **20,000+** * Tested up to **6.7.5** * Languages * [Dutch](https://nl.wordpress.org/plugins/wp-paginate/), [English (US)](https://wordpress.org/plugins/wp-paginate/), and [Russian](https://ru.wordpress.org/plugins/wp-paginate/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/wp-paginate) * Tags * [navigation](https://wordpress.org/plugins/tags/navigation/)[page](https://wordpress.org/plugins/tags/page/) [Paginate](https://wordpress.org/plugins/tags/paginate/)[pagination](https://wordpress.org/plugins/tags/pagination/) [wp-paginate](https://wordpress.org/plugins/tags/wp-paginate/) * [Advanced View](https://wordpress.org/plugins/wp-paginate/advanced/) ## Ratings 4.6 out of 5 stars. * [ 91 5-star reviews ](https://wordpress.org/support/plugin/wp-paginate/reviews/?filter=5) * [ 7 4-star reviews ](https://wordpress.org/support/plugin/wp-paginate/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/wp-paginate/reviews/?filter=3) * [ 1 2-star review ](https://wordpress.org/support/plugin/wp-paginate/reviews/?filter=2) * [ 8 1-star reviews ](https://wordpress.org/support/plugin/wp-paginate/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/wp-paginate/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/wp-paginate/reviews/) ## Contributors * [ maxfoundry ](https://profiles.wordpress.org/maxfoundry/) * [ Eric ](https://profiles.wordpress.org/emartin24/) * [ AlanP57 ](https://profiles.wordpress.org/alanp57/) ## Support Issues resolved in last two months: 0 out of 1 [View support forum](https://wordpress.org/support/plugin/wp-paginate/)