get_comments() – Function | Developer.WordPress.org

Retrieves a list of comments.

Description

The comment list can be for the blog as a whole or for an individual post.

Parameters

$argsstring|arrayoptional: Array or string of arguments. See WP_Comment_Query::__construct() for information on accepted arguments.
Default:''

Return

WP_Comment[]|int[]|int List of comments or number of found comments if $count argument is true.

Source

	return $_comment;
} elseif ( ARRAY_A === $output ) {
	return $_comment->to_array();
} elseif ( ARRAY_N === $output ) {

View all references View on Trac View on GitHub

Changelog

Version	Description
2.7.0	Introduced.

User Contributed Notes

Skip to note 9 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 7You must log in to vote on the helpfulness of this note
Show comment counts of a post
```
$args = array(
	'post_id' => 1,   // Use post_id, not post_ID
        'count'   => true // Return only the count
);
$comments_count = get_comments( $args );
echo $comments_count;
```
Log in to add feedback
Skip to note 10 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
Get comments from last 4 weeks
```
$args = array(
	'date_query' => array(
		'after' => '4 weeks ago',
		'before' => 'tomorrow',
		'inclusive' => true,
	),
);

$comments = get_comments( $args );
foreach ( $comments as $comment ) {
	// Output comments etc here
}
```
Log in to add feedback
Skip to note 11 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Example
```
$comments = get_comments( array( 'post_id' => 15 ) );

foreach ( $comments as $comment ) :
	echo $comment->comment_author;
endforeach;
```
Log in to add feedback

Codex 9 years ago

Show last 5 unapproved comments

$args = array(
	'status'  => 'hold',
	'number'  => '5',
	'post_id' => 1, // use post_id, not post_ID
);
$comments = get_comments( $args );

foreach ( $comments as $comment ) :
	echo $comment->comment_author . '<br />' . $comment->comment_content;
endforeach;

Skip to note 13 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Show comment counts of a user
```
$args = array(
	'user_id' => 1,   // Use user_id.
	'count'   => true // Return only the count.
);
$comments_count = get_comments( $args );

echo $comments_count;
```
Log in to add feedback
Skip to note 14 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Show comments of a user
```
<?php
$args = array(
	'user_id' => 1, // use user_id
);
$comments = get_comments( $args );

foreach ( $comments as $comment ) :
	echo $comment->comment_author . '<br />' . $comment->comment_content;
endforeach;
```
Log in to add feedback
Skip to note 15 content

Mehedi Foysal 4 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Get all comments of two post types:
```
$paged = get_query_var( 'page' ) ? get_query_var( 'page' ) : 1;
$args  = array(
	'number'    => 5,
	'post_type' => array( 'property', 'page' ),
    'paged' => $paged,
    'parent' => 0,
);
$comments = get_comments($args);
```
Log in to add feedback
Skip to note 16 content

Mehedi Foysal 4 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Get child comment of parent comment
```
$args           = array(
    'parent'       => $comment->comment_ID, //Comment ID '64'
    'hierarchical' => true,
    'status'       => 'approve',
);
$child_comments = get_comments( $args );
```
or you can use get_children()
```
$comment->get_children()
```
Log in to add feedback

get_comments( string|array $args = '' ): WP_Comment[]|int[]|int

In this article