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

function get_comments( $args = '' ) {
	$query = new WP_Comment_Query();
	return $query->query( $args );
}

View all references View on Trac View on GitHub

Uses	Description
WP_Comment_Query::__construct()`wp-includes/class-wp-comment-query.php`	Constructor.

Used by	Description
WP_Comments_List_Table::comment_type_dropdown()`wp-admin/includes/class-wp-comments-list-table.php`	Displays a comment type drop-down for filtering on the Comments list table.
wp_comments_personal_data_exporter()`wp-includes/comment.php`	Finds and exports personal data associated with an email address from the comments table.
wp_comments_personal_data_eraser()`wp-includes/comment.php`	Erases personal data associated with an email address from the comments table.
WP_Comment::get_children()`wp-includes/class-wp-comment.php`	Gets the children of a comment.
WP_Comment_Query::fill_descendants()`wp-includes/class-wp-comment-query.php`	Fetch descendants for located comments.
wp_dashboard_recent_comments()`wp-admin/includes/dashboard.php`	Show Comments section.
post_comment_meta_box()`wp-admin/includes/meta-boxes.php`	Displays comments for post.
WP_Comments_List_Table::get_views()`wp-admin/includes/class-wp-comments-list-table.php`
WP_Comments_List_Table::prepare_items()`wp-admin/includes/class-wp-comments-list-table.php`
WP_Widget_Recent_Comments::widget()`wp-includes/widgets/class-wp-widget-recent-comments.php`	Outputs the content for the current Recent Comments widget instance.
wp_xmlrpc_server::wp_getComments()`wp-includes/class-wp-xmlrpc-server.php`	Retrieves comments.
wp_list_comments()`wp-includes/comment-template.php`	Displays a list of comments.
get_comment_count()`wp-includes/comment.php`	Retrieves the total comment counts for the whole site or a single post.

Show 8 more Show less

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 3 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 3 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

Description

Parameters

Return

Source

Changelog

User Contributed Notes

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

In this article

Description

Parameters

Return

Source

Related

Changelog

User Contributed Notes