Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/comments number


Displays the total number of comments, Trackbacks, and Pingbacks for the current post. This tag must be within The Loop.

Use get_comments_number() to retrieve the value.


 <?php comments_number$zero$one$more ); ?> 


(string) (optional) Text to display when there are no comments.
Default: 'No Comments'
(string) (optional) Text to display when there is one comment.
Default: '1 Comment'
(string) (optional) Text to display when there is more than one comment. % is replaced by the number of comments, so '% so far' is displayed as "5 so far" when there are five comments.
Default: '% Comments'


Text Response to Number of Comments

Displays text based upon number of comments: Comment count zero - no responses; comment count one - one response; more than one comment (total 42) displays 42 responses.

  This post currently has
  <?php comments_number( 'no responses', 'one response', '% responses' ); ?>.

Title For Comments Section

You might want to have a title above your comments section that includes the number of comments. This example shows how to do that and have all the strings also be translatable.

printf( _nx( 'One Comment', '%1$s Comments', get_comments_number(), 'comments title', 'textdomain' ), number_format_i18n( get_comments_number() ) );


Change Log

Since: 0.71

Source File

comments_number() is located in wp-includes/comment-template.php


Comments Functions

See also index of Function Reference and index of Template Tags.