WordPress Paged Comments Plugin

This plugin is no longer being developed. WordPress has had paged comments support in the core since version 2.7. The comment paging you see here is using WordPress’s built-in code and not my plugin.

Paged Comments is a plugin for WordPress to allow comment paging. Useful for those popular blog entries receiving many comments, or a simple guestbook page within WordPress.


  • Comment ordering: show latest comments first, or last
  • Specify number of comments to display per page
  • Enable paging for all posts and pages, or on a per-post basis
  • Give users the choice to view all comments on one page with a ‘show all’ link
  • Specify the first or last page of comments to load by default
  • See paged-comments-config-sample.php for more

Download — Latest Version

Installation (for WordPress 2.3 up to 2.7)

If you’re upgrading from a previous version, skip these installation steps and read the upgrade steps. Note: WordPress’ automatic upgrade feature will erase the plugin’s config file. If you’re going to use it, make sure you backup your paged-comments-config.php file first.

  1. Download and extract plugin files to a folder locally.
  2. Read through and edit paged-comments-config-sample.php to configure, then save the file as paged-comments-config.php.
  3. Upload the whole paged-comments directory to /wp-content/plugins/. The plugin files should now be in /wp-content/plugins/paged-comments/.
  4. Enable the plugin through the WordPress admin interface. That’s it!

Optional Steps

  • WP 2.7 users: If use_wp_config is set to true (default), you can make changes to the plugin config using the WP admin interface. Go to Settings > Discussion and look under ‘Other comment settings’.
  • To customise the template to work better with your theme: Open the plugin’s themes folder and find the subfolder corresponding to the WordPress theme you’d like paged comments enabled on (or if your theme isn’t listed, choose the ‘default’ folder). Upload comments-paged.php to the appropriate WordPress theme folder (found in [wordpress]/wp-content/themes/).

    For example, if you’re using the default WordPress theme, copy [paged-comments-plugin]/themes/default/comments-paged.php to [wordpress]/wp-content/themes/default/. (The plugin always tries to load comments-paged.php from your active theme folder first.)

    Make any modifications to comments-paged.php. The file is based on the comments.php file, so if your theme is very different it might be easier to copy in the necessary elements from paged-comments.php. View the diff report to see what you need to change.

Examples of Use

The comments on this page are handled by the plugin, but it’s also used by the following sites:


Paid Support

If you run a commercial site and you’re having difficulty setting up paged comments, I offer paid support. Feel free to get in touch: keyvan (at) k1m.com


  1. TonyN says:


    Re #698 and #699, Many thanks.

    I have tried putting comments-paged.php from Page Comments version 2.5 in the /blog/wp-content/themes/tiga-06, which I assume is what you were suggesting. This gets rid of the ‘Call to undefined function: get_avatar()’ error message and the comments etc are displayed, but without any formatting. They just display right across the window over the default background of the theme, not in the comment area.

    Any suggestions, or am I asking the impossible?

    I cannot find a download of Paged Comments version 2.6

  2. Dave says:

    Thanks for this, is there a way to make this work with Sexy Comments?

    Thanks again

  3. Is there a way to remove the gravatars?? I don’t want that and they’re slowing my page down.

  4. TonyN says:


    Update on #701: I have now tried ver 2.6, but with the same results.

  5. Keyvan says:

    TonyN: If the default comments-paged.php is not compatible with your theme, you’ll have to create a custom template file. This involves a bit more work. The easiest way is to save a copy of /wp-content/themes/tiga-06/comments.php as /wp-content/themes/tiga-06/comments-paged.php. Then edit this comments-paged.php file and copy in the paging code from the default comments-paged.php file. You can see an example of changes made to the default comments-paged.php file to enable paging. Yours won’t be exactly the same, but it shouldn’t differ too much.

    Dave: If that’s another plugin, I don’t have time right now to look into compatibility issues.

    A Cowboy’s Wife: You should be able to remove gravatars by editing comments-paged.php and removing the line that pulls in gravatars.

  6. […] un moment donné, ça suffit! J’ai ajouté un plugin de pagination des commentaires pour éviter que les pages avec plusieurs commentaires aient 3 km de long et prennent 10 minutes à […]

  7. Dan says:


    I’m having trouble with the links to pages and comments.

    If fancy_urls is set to true, the page navigation doesn’t work. Currently I have 5 comments per page, and the links to the pages are in the format:


    However, the links all go to:


    If fancy_urls is turned off, the links to pages are in the format:


    and they go to:


    (/comments is a page I have created for feedback – like a guestbook)

    I’m using WordPress Version 2.6.

    Any ideas?

  8. Hello Keyvan,

    Just a heads-up to thank you again for this great plugin.

    I can confirm that we have the Paged Comments 2.7.1 working just fine with WordPress 2.6 and the K2 theme (v1.0-RC7) over at http://www.timmclean.org <- a memorial tribute site.

    BTW, Dan, just below me…. do you have Permalinks set up and working correctly in your WordPress installation? We have fancy URLs working properly.


  9. Dan says:

    Hi Rob, I do have permalinks set up and working. Just not the right settings!

    After experimenting with the WP permalinks settings, I found that a custom format was the problem. I don’t need it, so I’m using one of the presets.

    Using a preset instead of a custom setting doesn’t actually change the permalinks for pages, but fixes the problem nonetheless.

    So the plugin is working fine now.

  10. Keyvan says:

    Tim: Thanks. I’m glad it worked okay for you.

    Dan: I’m glad it’s now working, but I’d be interested to know what custom format you were using that caused the plugin to fail.

  11. PARIS says:

    I recognized a problem: Paged Comments (Version 2.6.4) does not work, if WordPress is installed in a subdirectory (example.com/wordpress) and called from homedirectory (example.com). The links to the individual pages are wrong then.

    How can i fix this Problem, without changing the directory?

  12. Keyvan says:

    Paris: I’ve tested the plugin using WP installed in a subdirectory, try here. I’m not sure what you mean by ‘and called from homedirectory’ though, are you accessing it in a different way?

  13. Dan says:

    Keyvan, I was using the permalink format: %postname%-%post_id%

    What is weird is that this doesn’t effect the URL of pages, which is where I was having the problem.

    I haven’t got as far as sorting out comments on posts. I’ll let you know if I have any further issues with it.

  14. ParisReply says:

    Yes Keyvan I’m testing it in a different way.
    I set My Blog Home address
    My WordPress address
    the page number will be shown but when I click It will display a wrong link (example.com/wordpress/?p=5&cp=1#comments) this link can’t work on my site. The right link should be (example.com/?p=5&cp=1#comments)

    when I set My Blog Home address
    My WordPress address
    the page link can work very well but I can’t login in my wordpress and all the CSS disappear.

    when I set My Blog Home address
    My WordPress address
    everything works perfect
    but I don’t wanna my site permalink containing a /wordpress/
    all I wanna do is set My Blog Home address
    My WordPress address

    however it can’t work well I don’t know why?
    (I’m from China I use WP2.6 English version and paged comments Version 2.7.1)Thank you!

  15. Christina says:

    I am having the same problem as Paris. Example: In this post when I click on page 3. It tries to take me here. That is not where my posts/blogs are located.

    I think what Paris meant by “subdirectory (example.com/wordpress) and homedirectory (example.com)” is
    wordpress address (example.com/wordpress) and blog address (example.com). I have wordpress in it’s own directory while my blog remains in my root directory (Read)

    Please let me know if a solution to this problem becomes available. Thanks!

  16. Keyvan says:

    Dan: Thanks, I’m going to look into it and see if I can reproduce the problem using custom permalinks.

    Paris, Christina: Thanks for the information. I have to admit, I wasn’t aware you could set WordPress up in this way. Expect another release soon. 🙂

  17. skapiso says:

    Hi keyvan, thank you for your plugin. It help me because i have a page with more than 350 comments and it’s impossible to display without a pagination script. I encounter a little problem. I have chose to display my comments with a DESC order. the script works well but if there is only 2 comments left at the end of the modulo, the first page of the pagination will contain only 2 comments, even if chosse to display 25 comments per page. Do you understand what I mean? Sorry for my english. I hope you could help me.


  18. skapiso says:

    I note this is the same thing here. there is at the moment 8 comments even if you propably choose to display 10. is there any solution to resolve this little bug?

  19. Keyvan says:

    skapiso: You can change the behaviour by setting fill_last_page to true in the config file. The reason it works the way it does is to prevent comments moving from page to page. It’s not very convenient for viewing comments, but does make it easier for people trying to link to a specific comment, or coming in from a search engine.

  20. otto says:

    Hi keyvan, I wana know if it’s possible to hide the “show all” option because I have an “Maximum execution time of 30 seconds exceeded” error when I try to display the 300 comments of my page. It’s strange because your page counts more than 700 ….

    Thanks a lot

  21. skapiso says:

    Hi keyvan, I see what you mean by there. In my utilisation I d’ont need to link my comments, so I’ll trie your option.

    Thank you for your help and keep courage for the futur ajax version 🙂

  22. Goob says:

    I feel like a dolt for not being able to figure this out and I didn’t see anyone else having this problem here, but does anybody know how to get the navigation to show up? What I mean is that page numbers and the next / previous arrows simply aren’t showing up on my posts.

    The plugin works great at filtering my comments down to 25 per page and ordering them in ASC, but all I’m seeing is 25 comments with no way to get to the rest. What am I doing wrong at 3:25am? 🙂

  23. Goob says:

    Jesus, sorry about this double post. Of course after spending 30 minutes trying to figure out what was wrong, I find it 2 seconds after posting for help.

    Looks like this plugin and the AJAX comment one I use are incompatible. Oh well, no biggie I guess. Here’s the site of the plugin, just in case you didn’t know about it.


  24. […] (1)KEYVAN???????Version 2.6.4 (2007-07-31) (zip file) ???????????? ?paged-comments????? paged-comments-config-sample.php???? paged-comments.php???? languages??? themes??? readme.txt ?5??????????? […]

  25. […] to achieve the contact form. This fantastic plugin is from Mike Cherim and Mike Jolley.I also use Paged Comments by Keyvan Minoukadeh to make comments paged. Thanks to you guys. You are so talented web […]

  26. Adam says:

    Hi, I just managed to fix the problem with page-comment-num fancy urls not working on custom permalinks structure, actually the problem was the paged-comments expect slash at the permalinks structure while it doesn’t need to be there (it is not in my case: /%category%/%postname%)

    Here’s the patch that does the job for me:

  27. Keyvan says:

    otto: Please try setting show_all_option to false.

    Goob: Thanks for letting me know. I don’t have time to look into compatibility issues right now, but I’ll keep it mind.

  28. Keyvan says:

    2.8 release

    This release should fix the following issues:

    • Invalid URLs generated when WordPress installed in its own directory (thanks Christina, Paris)
    • Permalink structures with no trailing slash not handled correctly (thanks Adam, Dan)
  29. Paris says:

    Keyvan: thank you so much. You really fix the problem in version 2.8 and paged comments works very well when WordPress installed in its own directory. Thanks you again! If you come to China, I’ll definitly buy you a coffee.

  30. […] update v2.8 20 August 2008 19:40 Cel mai frumos scris si util plugin de paginare a comentarilor – Paged comments a lui Keyvan Minoukadeh – a primit un update pe care il asteptam de multa vreme: versiunea 2.8 rezolva problema (cu lipsa) […]

  31. Keyvan says:

    Paris: Thanks! Glad it’s working for you now. 🙂

  32. caro says:

    Excellent work! But, I want to use the Spanish language, what should I do?

  33. Rick says:

    Problem with the 2.8 upgrade.

    Initially I used the upgrade button provided on the WP plugin page. It seems to do it but the paged-comments entry on the plugins page vanishes. On my second one I did it by hand and it was ok. Looking closer it seems that when done automatically it ends up too deep in the directory hierarchy i.e. …\plugins\pages-comments\paged-comments\… When I moved it up one then it was ok again. The zip seems to be structured like that as well.

  34. Keyvan says:

    caro: You specify the language in your wp-config.php file. See here. Let me know if that helps.

    Rick: Thanks for letting me know. I guess the automatic upgrade option uses the WP plugin directory. I just tried downloading the current release from the plugin directory and it had the nesting problem you mention. Unfortunately I don’t have much control over that – and I’ve had problems with it in the past. As far as I know I can’t tell it to use the releases that I make available on my site. I’ve just restructured the directories on the subversion server, however, and that appears to have fixed it. Thanks again.

  35. […] solution is the WordPress paged comments plugin. This little plugin allows you to have paged comments on your blog instead of having a single page […]

  36. TonyN says:


    Many thanks for your help in #706, and I now have Paged Comments 2.8 running with Tiga-06 and looking good. There is just one problem, referred to by Hoboken in #248 and Roger in #676. The numbering starts again from 1 on each page and I can’t find a fix in any of the other comments here. No problem when using All Pages and the permalinks seem to be OK..

    The relevant code in the template file seems to be:

    <a class=”comment-num”
    href=”#comment-<?php comment_ID() ?>”
    title=”<?php _te(‘Permanent link to this comment’); ?>”>
    <?php echo $comment_num ?>

    [Edited to fix markup]

    Unfortunately I am nor a php mechanic and I am reluctant to fiddle with this as Paged Comments will be running on only one page on my blog (where there are over 1200 comments) and I don’t want to risk jogging everything.

    Sorry to come back to you yet again.

  37. W-Shadow says:

    I think I’ve found a bug : when using this plugin the comment form fields (Name, Mail, Website) are never pre-filled with the info stored in cookies. I’ve tried it on two blogs (WP 2.6.1, default config for the plugin) and it happens on both sites.

    By the way, I’ve verified that the cookies are correctly set and are retained by the browser.

  38. Johan says:

    Hi Keyvan!

    First time for me that I use the automatic plugin update function of WP 2.6 and Paged comments auto-update (from 2.7.1 to 2.8) deleted my previous ‘paged-comments-config.php’ file…. Fortunatly, I did this auto-update only on my local testing-server, just before updating WP to 2.6.1 (that I will do in a few minutes) and I could retreive my settings from my online server.

    It seems that the auto-update fully erase Paged comments folder… Is it a bug that you could fix (is it already fixed?) or have I done something wrong?

    Again, many thanx for this plugin 😉 !


  39. Keyvan says:

    Tony: If you look at the difference report (specifically diff #3), you’ll see where I’ve included code to give you the correct comment number. In addition to that I disabled the list numbering that WP uses by default with the following CSS rule: style=”list-style-type: none;”. You’ll see that in the diff report as well. Hope that helps.

    W-Shadow: I’ll have a look into this. Thanks for letting me know.

    Johan: I’ve never used the auto-update feature myself, so I’m not sure how the update is handled. But I’ll take a look and see if I have the same problem. Thanks for letting me know.

  40. DarkPepe says:

    I agree with you, this is a bug. Paged comments is currently whiping the pre-filled info on the comment form 🙁 Anyone can search for a fix? Sadly I’m not a php coder.

  41. TonyN says:

    Keyvan: It worked in the end, and it was worth it. Many thanks for your help and patience with a php newbie.

  42. Viper007Bond says:

    Great plugin! Been meaning to install it for AGES but I only finally go around to it the other day, heh.

    One suggestion though: the option to exclude pings from being listed. I display my pingbacks seperately.

    I’ve hacked the plugin’s queries myself to make that happen, but it’d be nice if it was just a configuration option.

  43. nicola says:

    Great plugin but it’s difficoult for me to integrate the comments.paged.php files in my theme… someone have a modified version of the file for the DUFFY themes (by Infocreek)
    Thanks for your attention

  44. Catrina says:

    Version 2.7 and 2.8 both have a problem with session state. Reverting to version 2.6.4 solved our problem.

    This is the same bug that W-Shadow mentioned on the prev. page.

  45. anonymous says:

    Hey Keyvan,

    Could you look into Post 741 by DarkPepe? I got the same problem. For example, i have set my comments form to german. By using the plugin it overwrites this settings, reverting it to english. Any way to fix this perhaps?


  46. PsyKater says:

    What a great plugin!

    But I have a problem. I used it to create a guestbook (see weblink) but now i have all sites listed between the text and the comments, when the plugin is active. Could you please help me? Thanks a lot!

    Greetings from Germany!


  47. Monika says:

    Hi I’m using Version 2.8 (2008-08-19) – your plugin breaks the <!–nextpage–> function in static pages.

    Do you know how I can solve this problem?

    thanks a lot

  48. Marcelo says:

    Hey, Great job, and great plugin. We used it on WP 2.3, we upgraded to WP 2.6, but the plug-in seems not to work. We are using version 2.8. could yo please check it? Thanks in advance

  49. Roy says:

    Great plug-in. I missed the comment numbering in the comments, mite want to mention it in the readme – ben looking for a solution for a while, most of our posts have +1000 comments

6 Trackbacks

  1. […] Paged Comments […]

  2. […] un moment donné, ça suffit! J’ai ajouté un plugin de pagination des commentaires pour éviter que les pages avec plusieurs commentaires aient 3 km de long et prennent 10 minutes à […]

  3. By Guestbook??? Paged Comments Plugin - : ???? on 18 August 2008 at 1:42 am

    […] (1)KEYVAN???????Version 2.6.4 (2007-07-31) (zip file) ???????????? ?paged-comments????? paged-comments-config-sample.php???? paged-comments.php???? languages??? themes??? readme.txt ?5??????????? […]

  4. […] to achieve the contact form. This fantastic plugin is from Mike Cherim and Mike Jolley.I also use Paged Comments by Keyvan Minoukadeh to make comments paged. Thanks to you guys. You are so talented web […]

  5. By Paged comments plugin update v2.8 | de ce? blog on 20 August 2008 at 6:44 pm

    […] update v2.8 20 August 2008 19:40 Cel mai frumos scris si util plugin de paginare a comentarilor – Paged comments a lui Keyvan Minoukadeh – a primit un update pe care il asteptam de multa vreme: versiunea 2.8 rezolva problema (cu lipsa) […]

  6. By Dealing with too many comments - SEO Horror on 23 August 2008 at 6:35 am

    […] solution is the WordPress paged comments plugin. This little plugin allows you to have paged comments on your blog instead of having a single page […]