wp user list

Lists users.

$ wp user list [--role=<role>] [--<field>=<value>] [--network] [--field=<field>] [--fields=<fields>] [--format=<format>]

Display WordPress users based on all arguments supported by WP_User_Query().


Only display users with a certain role.
Control output by one or more arguments of WP_User_Query().
List all users in the network for multisite.
Prints the value of a single field for each user.
Limit the output to specific object fields.
Render output in a particular format. --- default: table options:
  • table
  • csv
  • ids
  • json
  • count
  • yaml ---


These fields will be displayed by default for each user:

  • ID
  • user_login
  • display_name
  • user_email
  • user_registered
  • roles

These fields are optionally available:

  • user_pass
  • user_nicename
  • user_url
  • user_activation_key
  • user_status
  • spam
  • deleted
  • caps
  • cap_key
  • allcaps
  • filter
  • url


# List user IDs
$ wp user list --field=ID

# List users with administrator role
$ wp user list --role=administrator --format=csv
1,supervisor,supervisor,supervisor@gmail.com,"2016-06-03 04:37:00",administrator

# List users with only given fields
$ wp user list --fields=display_name,user_email --format=json

# List users ordered by the 'last_activity' meta value.
$ wp user list --meta_key=last_activity --orderby=meta_value_num


--path=<path> Path to the WordPress files.

--url=<url> Pretend request came from given URL. In multisite, this argument is how the target site is specified.

--ssh=[<scheme>:][<user>@]<host|container>[:<port>][<path>] Perform operation against a remote server over SSH (or a container using scheme of "docker", "docker-compose", "vagrant").

--http=<http> Perform operation against a remote WordPress installation over HTTP.

--user=<id|login|email> Set the WordPress user.

--skip-plugins[=<plugins>] Skip loading all plugins, or a comma-separated list of plugins. Note: mu-plugins are still loaded.

--skip-themes[=<themes>] Skip loading all themes, or a comma-separated list of themes.

--skip-packages Skip loading all installed packages.

--require=<path> Load PHP file before running the command (may be used more than once).

--[no-]color Whether to colorize the output.

--debug[=<group>] Show all PHP errors and add verbosity to WP-CLI output. Built-in groups include: bootstrap, commandfactory, and help.

--prompt[=<assoc>] Prompt the user to enter values for all command arguments, or a subset specified as comma-separated values.

--quiet Suppress informational messages.

Related commands
wp user add-cap

Adds a capability to a user.

wp user add-role

Adds a role for a user.

wp user check-password

Checks if a user's password is valid or not.

wp user create

Creates a new user.

wp user delete

Deletes one or more users from the current site.

wp user generate

Generates some users.

wp user get

Gets details about a user.

wp user import-csv

Imports users from a CSV file.

wp user list

Lists users.

wp user list-caps

Lists all capabilities for a user.

wp user meta

Adds, updates, deletes, and lists user custom fields.

wp user remove-cap

Removes a user's capability.

wp user remove-role

Removes a user's role.

wp user reset-password

Resets the password for one or more users.

wp user session

Destroys and lists a user's sessions.

wp user set-role

Sets the user role.

wp user spam

Marks one or more users as spam.

wp user term

Adds, updates, removes, and lists user terms.

wp user unspam

Removes one or more users from spam.

wp user update

Updates an existing user.