comments_number( string $zero = false, string $one = false, string $more = false, string $deprecated = '' )

Display the language string for the number of comments the current post has.

Description Description

Parameters Parameters


(string) (Optional) Text for no comments.

Default value: false


(string) (Optional) Text for one comment.

Default value: false


(string) (Optional) Text for more than one comment.

Default value: false


(string) (Optional) Not used.

Default value: ''

Top ↑

Source Source

File: wp-includes/comment-template.php

function comments_number( $zero = false, $one = false, $more = false, $deprecated = '' ) {
	if ( ! empty( $deprecated ) ) {
		_deprecated_argument( __FUNCTION__, '1.3.0' );
	echo get_comments_number_text( $zero, $one, $more );

Top ↑

Changelog Changelog

Version Description
0.71 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Codex

    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' ); ?>.
  2. Skip to note 2 content
    Contributed by Codex

    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() ) );

You must log in before being able to contribute a note or feedback.