Title: wp comment list Published: February 5, 2018 Last modified: May 23, 2026 --- # 󠀁[wp comment list ](https://developer.wordpress.org/cli/commands/comment/list/)󠁿 Gets a list of comments. ## In this article * [Options](https://developer.wordpress.org/cli/commands/comment/list/?output_format=md#options) * [Available Fields](https://developer.wordpress.org/cli/commands/comment/list/?output_format=md#available-fields) * [Examples](https://developer.wordpress.org/cli/commands/comment/list/?output_format=md#examples) * [Global Parameters](https://developer.wordpress.org/cli/commands/comment/list/?output_format=md#global-parameters) [ Back to top](https://developer.wordpress.org/cli/commands/comment/list/?output_format=md#wp--skip-link--target) [ ⌊GitHub⌉ ](https://github.com/wp-cli/entity-command) [ View Open Issues (0) ](https://github.com/login?return_to=%2Fissues%3Fq%3Dlabel%3Acommand%3Acomment-list+sort%3Aupdated-desc+org%3Awp-cli+is%3Aopen) [ View Closed Issues (7) ](https://github.com/login?return_to=%2Fissues%3Fq%3Dlabel%3Acommand%3Acomment-list+sort%3Aupdated-desc+org%3Awp-cli+is%3Aclosed) [Create New Issue](https://github.com/wp-cli/entity-command/issues/new) Display comments based on all arguments supported by [WP_Comment_Query()](https://developer.wordpress.org/reference/classes/WP_Comment_Query/__construct/). ### 󠀁[Options](https://developer.wordpress.org/cli/commands/comment/list/?output_format=md#options)󠁿 See the [argument syntax](https://make.wordpress.org/cli/handbook/references/argument-syntax/) reference for a detailed explanation of the syntax conventions used. [-- =] One or more args to pass to [WP_Comment_Query](https://developer.wordpress.org/reference/classes/wp_comment_query/).[-- field=] Prints the value of a single field for each comment. [--fields=] Limit the output to specific object fields. [--format=] Render output in a particular format. —default: table options: – table – ids – csv – json – count– yaml— ### 󠀁[Available Fields](https://developer.wordpress.org/cli/commands/comment/list/?output_format=md#available-fields)󠁿 These fields will be displayed by default for each comment: * comment_ID * comment_post_ID * comment_date * comment_approved * comment_author * comment_author_email These fields are optionally available: * comment_author_url * comment_author_IP * comment_date_gmt * comment_content * comment_karma * comment_agent * comment_type * comment_parent * user_id * url ### 󠀁[Examples](https://developer.wordpress.org/cli/commands/comment/list/?output_format=md#examples)󠁿 ``` # List comment IDs. $ wp comment list --field=ID 22 23 24 # List comments of a post. $ wp comment list --post_id=1 --fields=ID,comment_date,comment_author +------------+---------------------+----------------+ | comment_ID | comment_date | comment_author | +------------+---------------------+----------------+ | 1 | 2015-06-20 09:00:10 | Mr WordPress | +------------+---------------------+----------------+ # List approved comments. $ wp comment list --number=3 --status=approve --fields=ID,comment_date,comment_author +------------+---------------------+----------------+ | comment_ID | comment_date | comment_author | +------------+---------------------+----------------+ | 1 | 2015-06-20 09:00:10 | Mr WordPress | | 30 | 2013-03-14 12:35:07 | John Doe | | 29 | 2013-03-14 11:56:08 | Jane Doe | +------------+---------------------+----------------+ # List unapproved comments. $ wp comment list --number=3 --status=hold --fields=ID,comment_date,comment_author +------------+---------------------+----------------+ | comment_ID | comment_date | comment_author | +------------+---------------------+----------------+ | 8 | 2023-11-10 13:13:06 | John Doe | | 7 | 2023-11-10 13:09:55 | Mr WordPress | | 9 | 2023-11-10 11:22:31 | Jane Doe | +------------+---------------------+----------------+ # List comments marked as spam. $ wp comment list --status=spam --fields=ID,comment_date,comment_author +------------+---------------------+----------------+ | comment_ID | comment_date | comment_author | +------------+---------------------+----------------+ | 2 | 2023-11-10 11:22:31 | Jane Doe | +------------+---------------------+----------------+ # List comments in trash. $ wp comment list --status=trash --fields=ID,comment_date,comment_author +------------+---------------------+----------------+ | comment_ID | comment_date | comment_author | +------------+---------------------+----------------+ | 3 | 2023-11-10 11:22:31 | John Doe | +------------+---------------------+----------------+ ``` ### 󠀁[Global Parameters](https://developer.wordpress.org/cli/commands/comment/list/?output_format=md#global-parameters)󠁿 These [global parameters](https://make.wordpress.org/cli/handbook/config/) have the same behavior across all commands and affect how WP-CLI interacts with WordPress. | **Argument** | **Description** | | `--path=` | Path to the WordPress files. | | `--url=` | Pretend request came from given URL. In multisite, this argument is how the target site is specified. | | `--ssh=[:][@][:][]` | Perform operation against a remote server over SSH (or a container using scheme of “docker”, “docker-compose”, “docker-compose-run”, “vagrant”). | | `--http=` | Perform operation against a remote WordPress installation over HTTP. | | `--user=` | Set the WordPress user. | | `--skip-plugins[=]` | Skip loading all plugins, or a comma-separated list of plugins. Note: mu-plugins are still loaded. | | `--skip-themes[=]` | Skip loading all themes, or a comma-separated list of themes. | | `--skip-packages` | Skip loading all installed packages. | | `--require=` | Load PHP file before running the command (may be used more than once). | | `--exec=` | Execute PHP code before running the command (may be used more than once). | | `--context=` | Load WordPress in a given context. | | `--[no-]color` | Whether to colorize the output. | | `--debug[=]` | Show all PHP errors and add verbosity to WP-CLI output. Built-in groups include: bootstrap, commandfactory, and help. | | `--prompt[=]` | Prompt the user to enter values for all command arguments, or a subset specified as comma-separated values. | | `--quiet` | Suppress informational messages. | _Command documentation is regenerated at every release. To add or update an example, please submit a pull request against the corresponding part of the codebase._