README.md

wp-cli/entity-command
=====================

Manage WordPress comments, menus, options, posts, sites, terms, and users.

[![Testing](https://github.com/wp-cli/entity-command/actions/workflows/testing.yml/badge.svg)](https://github.com/wp-cli/entity-command/actions/workflows/testing.yml) [![Code Coverage](https://codecov.io/gh/wp-cli/entity-command/branch/main/graph/badge.svg)](https://codecov.io/gh/wp-cli/entity-command/tree/main)

Quick links: [Using](#using) | [Installing](#installing) | [Contributing](#contributing) | [Support](#support)

## Using

This package implements the following commands:

### wp comment

Creates, updates, deletes, and moderates comments.

~~~
wp comment
~~~

**EXAMPLES**

    # Create a new comment.
    $ wp comment create --comment_post_ID=15 --comment_content="hello blog" --comment_author="wp-cli"
    Success: Created comment 932.

    # Update an existing comment.
    $ wp comment update 123 --comment_author='That Guy'
    Success: Updated comment 123.

    # Delete an existing comment.
    $ wp comment delete 1337 --force
    Success: Deleted comment 1337.

    # Trash all spam comments.
    $ wp comment delete $(wp comment list --status=spam --format=ids)
    Success: Trashed comment 264.
    Success: Trashed comment 262.

    # Create a note for a block (WordPress 6.9+).
    $ wp comment create --comment_post_ID=15 --comment_content="This block needs revision" --comment_author="editor" --comment_type="note"
    Success: Created comment 945.

    # List notes for a specific post (WordPress 6.9+).
    $ wp comment list --type=note --post_id=15
    +------------+---------------------+----------------------------------+
    | comment_ID | comment_date        | comment_content                  |
    +------------+---------------------+----------------------------------+
    | 945        | 2024-11-10 14:30:00 | This block needs revision        |
    +------------+---------------------+----------------------------------+

    # Reply to a note (WordPress 6.9+).
    $ wp comment create --comment_post_ID=15 --comment_content="Updated per feedback" --comment_author="editor" --comment_type="note" --comment_parent=945
    Success: Created comment 946.

    # Resolve a note by adding a comment with status meta (WordPress 6.9+).
    $ wp comment create --comment_post_ID=15 --comment_content="Resolving" --comment_author="editor" --comment_type="note" --comment_parent=945 --porcelain
    947
    $ wp comment meta add 947 _wp_note_status resolved
    Success: Added custom field.

    # Reopen a resolved note (WordPress 6.9+).
    $ wp comment create --comment_post_ID=15 --comment_content="Reopening for further review" --comment_author="editor" --comment_type="note" --comment_parent=945 --porcelain
    948
    $ wp comment meta add 948 _wp_note_status reopen
    Success: Added custom field.



### wp comment approve

Approves a comment.

~~~
wp comment approve <id>...
~~~

**OPTIONS**

	<id>...
		The IDs of the comments to approve.

**EXAMPLES**

    # Approve comment.
    $ wp comment approve 1337
    Success: Approved comment 1337.



### wp comment count

Counts comments, on whole blog or on a given post.

~~~
wp comment count [<post-id>]
~~~

**OPTIONS**

	[<post-id>]
		The ID of the post to count comments in.

**EXAMPLES**

    # Count comments on whole blog.
    $ wp comment count
    approved:        33
    spam:            3
    trash:           1
    post-trashed:    0
    all:             34
    moderated:       1
    total_comments:  37

    # Count comments in a post.
    $ wp comment count 42
    approved:        19
    spam:            0
    trash:           0
    post-trashed:    0
    all:             19
    moderated:       0
    total_comments:  19



### wp comment create

Creates a new comment.

~~~
wp comment create [--comment_agent=<comment_agent>] [--comment_approved=<comment_approved>] [--comment_author=<comment_author>] [--comment_author_email=<comment_author_email>] [--comment_author_IP=<comment_author_IP>] [--comment_author_url=<comment_author_url>] [--comment_content=<comment_content>] [--comment_date=<yyyy-mm-dd-hh-ii-ss>] [--comment_date_gmt=<yyyy-mm-dd-hh-ii-ss>] [--comment_karma=<comment_karma>] [--comment_parent=<comment_parent>] [--comment_post_ID=<comment_post_ID>] [--comment_type=<comment_type>] [--comment_meta=<comment_meta>] [--user_id=<user_id>] [--<field>=<value>] [--porcelain]
~~~

**OPTIONS**

	[--comment_agent=<comment_agent>]
		The HTTP user agent of the comment author.

	[--comment_approved=<comment_approved>]
		Whether the comment has been approved. Default 1.

	[--comment_author=<comment_author>]
		The name of the author of the comment.

	[--comment_author_email=<comment_author_email>]
		The email address of the comment author.

	[--comment_author_IP=<comment_author_IP>]
		The IP address of the comment author.

	[--comment_author_url=<comment_author_url>]
		The URL address of the comment author.

	[--comment_content=<comment_content>]
		The content of the comment.

	[--comment_date=<yyyy-mm-dd-hh-ii-ss>]
		The date the comment was submitted.

	[--comment_date_gmt=<yyyy-mm-dd-hh-ii-ss>]
		The date the comment was submitted in the GMT timezone.

	[--comment_karma=<comment_karma>]
		The karma of the comment. Default 0.

	[--comment_parent=<comment_parent>]
		ID of this comment's parent, if any. Default 0.

	[--comment_post_ID=<comment_post_ID>]
		ID of the post that relates to the comment, if any.

	[--comment_type=<comment_type>]
		Comment type. Default 'comment'.

	[--comment_meta=<comment_meta>]
		Array in JSON format of comment meta values keyed by their comment meta key.

	[--user_id=<user_id>]
		ID of the user who submitted the comment. Default 0.

	[--<field>=<value>]
		Associative args for the new comment. See wp_insert_comment().

	[--porcelain]
		Output just the new comment id.

**EXAMPLES**

    # Create comment.
    $ wp comment create --comment_post_ID=15 --comment_content="hello blog" --comment_author="wp-cli"
    Success: Created comment 932.

    # Create a note (WordPress 6.9+).
    $ wp comment create --comment_post_ID=15 --comment_content="This block needs revision" --comment_author="editor" --comment_type="note"
    Success: Created comment 933.



### wp comment delete

Deletes a comment.

~~~
wp comment delete <id>... [--force]
~~~

**OPTIONS**

	<id>...
		One or more IDs of comments to delete.

	[--force]
		Skip the trash bin.

**EXAMPLES**

    # Delete comment.
    $ wp comment delete 1337 --force
    Success: Deleted comment 1337.

    # Delete multiple comments.
    $ wp comment delete 1337 2341 --force
    Success: Deleted comment 1337.
    Success: Deleted comment 2341.



### wp comment exists

Verifies whether a comment exists.

~~~
wp comment exists <id>
~~~

Displays a success message if the comment does exist.

**OPTIONS**

	<id>
		The ID of the comment to check.

**EXAMPLES**

    # Check whether comment exists.
    $ wp comment exists 1337
    Success: Comment with ID 1337 exists.



### wp comment generate

Generates some number of new dummy comments.

~~~
wp comment generate [--count=<number>] [--post_id=<post-id>] [--format=<format>]
~~~

Creates a specified number of new comments with dummy data.

**OPTIONS**

	[--count=<number>]
		How many comments to generate?
		---
		default: 100
		---

	[--post_id=<post-id>]
		Assign comments to a specific post.

	[--format=<format>]
		Render output in a particular format.
		---
		default: progress
		options:
		  - progress
		  - ids
		---

**EXAMPLES**

    # Generate comments for the given post.
    $ wp comment generate --format=ids --count=3 --post_id=123
    138 139 140

    # Add meta to every generated comment.
    $ wp comment generate --format=ids --count=3 | xargs -d ' ' -I % wp comment meta add % foo bar
    Success: Added custom field.
    Success: Added custom field.
    Success: Added custom field.



### wp comment get

Gets the data of a single comment.

~~~
wp comment get <id> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The comment to get.

	[--field=<field>]
		Instead of returning the whole comment, returns the value of a single field.

	[--fields=<fields>]
		Limit the output to specific fields. Defaults to all fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**EXAMPLES**

    # Get comment.
    $ wp comment get 21 --field=content
    Thanks for all the comments, everyone!



### wp comment list

Gets a list of comments.

~~~
wp comment list [--<field>=<value>] [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

Display comments based on all arguments supported by
[WP_Comment_Query()](https://developer.wordpress.org/reference/classes/WP_Comment_Query/__construct/).

**OPTIONS**

	[--<field>=<value>]
		One or more args to pass to WP_Comment_Query.

	[--field=<field>]
		Prints the value of a single field for each comment.

	[--fields=<fields>]
		Limit the output to specific object fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - ids
		  - csv
		  - json
		  - count
		  - yaml
		---

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

    # 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       |
    +------------+---------------------+----------------+

    # List notes for a specific post (WordPress 6.9+).
    $ wp comment list --type=note --post_id=15 --fields=ID,comment_date,comment_content
    +------------+---------------------+----------------------------------+
    | comment_ID | comment_date        | comment_content                  |
    +------------+---------------------+----------------------------------+
    | 10         | 2024-11-10 14:30:00 | This block needs revision        |
    | 11         | 2024-11-10 15:45:00 | Updated per feedback             |
    +------------+---------------------+----------------------------------+



### wp comment meta

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

~~~
wp comment meta
~~~

**EXAMPLES**

    # Set comment meta
    $ wp comment meta set 123 description "Mary is a WordPress developer."
    Success: Updated custom field 'description'.

    # Get comment meta
    $ wp comment meta get 123 description
    Mary is a WordPress developer.

    # Update comment meta
    $ wp comment meta update 123 description "Mary is an awesome WordPress developer."
    Success: Updated custom field 'description'.

    # Delete comment meta
    $ wp comment meta delete 123 description
    Success: Deleted custom field.





### wp comment meta add

Add a meta field.

~~~
wp comment meta add <id> <key> [<value>] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to create.

	[<value>]
		The value of the meta field. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp comment meta delete

Delete a meta field.

~~~
wp comment meta delete <id> [<key>] [<value>] [--all]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	[<key>]
		The name of the meta field to delete.

	[<value>]
		The value to delete. If omitted, all rows with key will deleted.

	[--all]
		Delete all meta for the object.



### wp comment meta get

Get meta field value.

~~~
wp comment meta get <id> <key> [--single] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to get.

	[--single]
		Whether to return a single value.

	[--format=<format>]
		Get value in a particular format.
		---
		default: var_export
		options:
		  - var_export
		  - json
		  - yaml
		---



### wp comment meta list

List all metadata associated with an object.

~~~
wp comment meta list <id> [--keys=<keys>] [--fields=<fields>] [--format=<format>] [--orderby=<fields>] [--order=<order>] [--unserialize]
~~~

**OPTIONS**

	<id>
		ID for the object.

	[--keys=<keys>]
		Limit output to metadata of specific keys.

	[--fields=<fields>]
		Limit the output to specific row fields. Defaults to id,meta_key,meta_value.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		  - count
		---

	[--orderby=<fields>]
		Set orderby which field.
		---
		default: id
		options:
		 - id
		 - meta_key
		 - meta_value
		---

	[--order=<order>]
		Set ascending or descending order.
		---
		default: asc
		options:
		 - asc
		 - desc
		---

	[--unserialize]
		Unserialize meta_value output.



### wp comment meta patch

Update a nested value for a meta field.

~~~
wp comment meta patch <action> <id> <key> <key-path>... [<value>] [--format=<format>]
~~~

**OPTIONS**

	<action>
		Patch action to perform.
		---
		options:
		  - insert
		  - update
		  - delete
		---

	<id>
		The ID of the object.

	<key>
		The name of the meta field to update.

	<key-path>...
		The name(s) of the keys within the value to locate the value to patch.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp comment meta pluck

Get a nested value from a meta field.

~~~
wp comment meta pluck <id> <key> <key-path>... [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to get.

	<key-path>...
		The name(s) of the keys within the value to locate the value to pluck.

	[--format=<format>]
		The output format of the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		  - yaml



### wp comment meta update

Update a meta field.

~~~
wp comment meta update <id> <key> [<value>] [--format=<format>]
~~~

**Alias:** `set`

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to update.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp comment recount

Recalculates the comment_count value for one or more posts.

~~~
wp comment recount <id>...
~~~

**OPTIONS**

	<id>...
		IDs for one or more posts to update.

**EXAMPLES**

    # Recount comment for the post.
    $ wp comment recount 123
    Updated post 123 comment count to 67.



### wp comment spam

Marks a comment as spam.

~~~
wp comment spam <id>...
~~~

**OPTIONS**

	<id>...
		The IDs of the comments to mark as spam.

**EXAMPLES**

    # Spam comment.
    $ wp comment spam 1337
    Success: Marked as spam comment 1337.



### wp comment status

Gets the status of a comment.

~~~
wp comment status <id>
~~~

**OPTIONS**

	<id>
		The ID of the comment to check.

**EXAMPLES**

    # Get status of comment.
    $ wp comment status 1337
    approved



### wp comment trash

Trashes a comment.

~~~
wp comment trash <id>...
~~~

**OPTIONS**

	<id>...
		The IDs of the comments to trash.

**EXAMPLES**

    # Trash comment.
    $ wp comment trash 1337
    Success: Trashed comment 1337.



### wp comment unapprove

Unapproves a comment.

~~~
wp comment unapprove <id>...
~~~

**OPTIONS**

	<id>...
		The IDs of the comments to unapprove.

**EXAMPLES**

    # Unapprove comment.
    $ wp comment unapprove 1337
    Success: Unapproved comment 1337.



### wp comment unspam

Unmarks a comment as spam.

~~~
wp comment unspam <id>...
~~~

**OPTIONS**

	<id>...
		The IDs of the comments to unmark as spam.

**EXAMPLES**

    # Unspam comment.
    $ wp comment unspam 1337
    Success: Unspammed comment 1337.



### wp comment untrash

Untrashes a comment.

~~~
wp comment untrash <id>...
~~~

**OPTIONS**

	<id>...
		The IDs of the comments to untrash.

**EXAMPLES**

    # Untrash comment.
    $ wp comment untrash 1337
    Success: Untrashed comment 1337.



### wp comment update

Updates one or more comments.

~~~
wp comment update <id>... [--comment_agent=<comment_agent>] [--comment_approved=<comment_approved>] [--comment_author=<comment_author>] [--comment_author_email=<comment_author_email>] [--comment_author_IP=<comment_author_IP>] [--comment_author_url=<comment_author_url>] [--comment_content=<comment_content>] [--comment_date=<yyyy-mm-dd-hh-ii-ss>] [--comment_date_gmt=<yyyy-mm-dd-hh-ii-ss>] [--comment_karma=<comment_karma>] [--comment_parent=<comment_parent>] [--comment_post_ID=<comment_post_ID>] [--comment_type=<comment_type>] [--comment_meta=<comment_meta>] [--user_id=<user_id>] --<field>=<value>
~~~

**OPTIONS**

	<id>...
		One or more IDs of comments to update.

	[--comment_agent=<comment_agent>]
		The HTTP user agent of the comment author.

	[--comment_approved=<comment_approved>]
		Whether the comment has been approved.

	[--comment_author=<comment_author>]
		The name of the author of the comment.

	[--comment_author_email=<comment_author_email>]
		The email address of the comment author.

	[--comment_author_IP=<comment_author_IP>]
		The IP address of the comment author.

	[--comment_author_url=<comment_author_url>]
		The URL address of the comment author.

	[--comment_content=<comment_content>]
		The content of the comment.

	[--comment_date=<yyyy-mm-dd-hh-ii-ss>]
		The date the comment was submitted.

	[--comment_date_gmt=<yyyy-mm-dd-hh-ii-ss>]
		The date the comment was submitted in the GMT timezone. Note that
		wp_update_comment() always recalculates this from 'comment_date'.

	[--comment_karma=<comment_karma>]
		The karma of the comment.

	[--comment_parent=<comment_parent>]
		ID of this comment's parent, if any.

	[--comment_post_ID=<comment_post_ID>]
		ID of the post that relates to the comment, if any.

	[--comment_type=<comment_type>]
		Comment type.

	[--comment_meta=<comment_meta>]
		Array in JSON format of comment meta values keyed by their comment meta key.

	[--user_id=<user_id>]
		ID of the user who submitted the comment.

	--<field>=<value>
		One or more fields to update. See wp_update_comment().

**EXAMPLES**

    # Update comment.
    $ wp comment update 123 --comment_author='That Guy'
    Success: Updated comment 123.



### wp font

Manages WordPress fonts.

~~~
wp font
~~~

**EXAMPLES**

    # List all font collections
    $ wp font collection list

    # Install a font family from a collection
    $ wp font family install google-fonts inter

    # List installed font families
    $ wp post list --post_type=wp_font_family

    # List installed font faces
    $ wp post list --post_type=wp_font_face



### wp font collection

Manages font collections.

~~~
wp font collection
~~~

Font collections are predefined sets of fonts that can be used in WordPress.
Collections are registered by WordPress core or themes and cannot be created
or deleted via the command line.

**EXAMPLES**

    # List all font collections
    $ wp font collection list
    +------------------+-------------------+---------+
    | slug             | name              | count   |
    +------------------+-------------------+---------+
    | google-fonts     | Google Fonts      | 1500    |
    +------------------+-------------------+---------+

    # Get details about a specific font collection
    $ wp font collection get google-fonts
    +-------+------------------+
    | Field | Value            |
    +-------+------------------+
    | slug  | google-fonts     |
    | name  | Google Fonts     |
    +-------+------------------+



### wp font collection get

Gets details about a registered font collection.

~~~
wp font collection get <slug> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<slug>
		Font collection slug.

	[--field=<field>]
		Instead of returning the whole collection, returns the value of a single field.

	[--fields=<fields>]
		Limit the output to specific fields. Defaults to all fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for the specified collection:

* slug
* name
* description
* categories

**EXAMPLES**

    # Get details of a specific collection
    $ wp font collection get google-fonts
    +-------+------------------+
    | Field | Value            |
    +-------+------------------+
    | slug  | google-fonts     |
    | name  | Google Fonts     |
    +-------+------------------+

    # Get the name field only
    $ wp font collection get google-fonts --field=name
    Google Fonts



### wp font collection is-registered

Checks if a font collection is registered.

~~~
wp font collection is-registered <slug>
~~~

**OPTIONS**

	<slug>
		Font collection slug.

**EXAMPLES**

    # Bash script for checking if a font collection is registered, with fallback.

    if wp font collection is-registered google-fonts 2>/dev/null; then
        # Font collection is registered. Do something.
    else
        # Fallback if collection is not registered.
    fi



### wp font collection list

Lists registered font collections.

~~~
wp font collection list [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	[--field=<field>]
		Prints the value of a single field for each collection.

	[--fields=<fields>]
		Limit the output to specific collection fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each collection:

* slug
* name
* description
* categories

**EXAMPLES**

    # List all font collections
    $ wp font collection list
    +------------------+-------------------+
    | slug             | name              |
    +------------------+-------------------+
    | google-fonts     | Google Fonts      |
    +------------------+-------------------+

    # List collections in JSON format
    $ wp font collection list --format=json
    [{"slug":"google-fonts","name":"Google Fonts"}]



### wp font collection list-categories

Lists categories in a collection.

~~~
wp font collection list-categories <slug> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<slug>
		Font collection slug.

	[--field=<field>]
		Prints the value of a single field for each category.

	[--fields=<fields>]
		Limit the output to specific category fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - yaml
		---

**AVAILABLE FIELDS**

* slug
* name

**EXAMPLES**

    # List all categories in a collection
    $ wp font collection list-categories google-fonts
    +-------------+--------------+
    | slug        | name         |
    +-------------+--------------+
    | sans-serif  | Sans Serif   |
    | display     | Display      |
    +-------------+--------------+



### wp font collection list-families

Lists font families in a collection.

~~~
wp font collection list-families <slug> [--category=<slug>] [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<slug>
		Font collection slug.

	[--category=<slug>]
		Filter by category slug.

	[--field=<field>]
		Prints the value of a single field for each family.

	[--fields=<fields>]
		Limit the output to specific family fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - yaml
		---

**AVAILABLE FIELDS**

* slug
* name
* fontFamily
* categories
* preview

**EXAMPLES**

    # List all font families in a collection
    $ wp font collection list-families google-fonts

    # List font families in a specific category
    $ wp font collection list-families google-fonts --category=sans-serif



### wp font face

Manages font faces.

~~~
wp font face
~~~

To list, get, create, update or delete font faces, use `wp post` with
`--post_type=wp_font_face`.

**EXAMPLES**

    # Install a font face for an existing family
    $ wp font face install 42 --src="https://example.com/font.woff2" --font-weight=700
    Success: Created font face 43.

    # List installed font faces
    $ wp post list --post_type=wp_font_face



### wp font face install

Installs a font face.

~~~
wp font face install <family-id> --src=<src> [--font-family=<family>] [--font-style=<style>] [--font-weight=<weight>] [--font-display=<display>] [--porcelain]
~~~

Creates a new font face post with the specified settings.

**OPTIONS**

	<family-id>
		Font family ID.

	--src=<src>
		Font face source URL or file path.

	[--font-family=<family>]
		CSS font-family value.

	[--font-style=<style>]
		CSS font-style value (e.g., normal, italic).
		---
		default: normal
		---

	[--font-weight=<weight>]
		CSS font-weight value (e.g., 400, 700).
		---
		default: 400
		---

	[--font-display=<display>]
		CSS font-display value.

	[--porcelain]
		Output just the new font face ID.

**EXAMPLES**

    # Install a font face
    $ wp font face install 42 --src="https://example.com/font.woff2" --font-weight=700 --font-style=normal
    Success: Created font face 43.

    # Install a font face with porcelain output
    $ wp font face install 42 --src="font.woff2" --porcelain
    44



### wp font family

Manages font families.

~~~
wp font family
~~~

To list, get, create, update or delete font families, use `wp post` with
`--post_type=wp_font_family`.

**EXAMPLES**

    # Install a font family from a collection
    $ wp font family install google-fonts inter
    Success: Installed font family "Inter" (ID: 42) with 9 font faces.

    # List installed font families
    $ wp post list --post_type=wp_font_family



### wp font family install

Installs a font family from a collection.

~~~
wp font family install <collection> <family> [--porcelain]
~~~

Retrieves a font family from a collection and creates the wp_font_family post
along with all associated font faces.

**OPTIONS**

	<collection>
		Font collection slug.

	<family>
		Font family slug from the collection.

	[--porcelain]
		Output just the new font family ID.

**EXAMPLES**

    # Install a font family from a collection
    $ wp font family install google-fonts inter
    Success: Installed font family "Inter" (ID: 42) with 9 font faces.

    # Install and get the family ID
    $ wp font family install google-fonts roboto --porcelain
    43



### wp icon

Manages registered SVG icons.

~~~
wp icon
~~~

Icons are registered in code with `wp_register_icon()` by WordPress core,
themes, and plugins, and always belong to an icon collection. Because they
only exist for the duration of a request, they cannot be created or deleted
from the command line.

Icon names are namespaced with the slug of the collection they belong to,
in the form `collection/icon-name`.

**EXAMPLES**

    # List all registered icons
    $ wp icon list
    +-----------------+------------+------------+
    | name            | label      | collection |
    +-----------------+------------+------------+
    | core/arrow-down | Arrow Down | core       |
    | core/plus       | Plus       | core       |
    +-----------------+------------+------------+

    # Get details about a single icon
    $ wp icon get core/plus --fields=name,label,collection
    +------------+-----------+
    | Field      | Value     |
    +------------+-----------+
    | name       | core/plus |
    | label      | Plus      |
    | collection | core      |
    +------------+-----------+

    # Render an icon at a given size, ready to be embedded in a template
    $ wp icon render core/plus --size=48 --label="Add item" > plus.svg



### wp icon collection

Manages icon collections.

~~~
wp icon collection
~~~

Icon collections group registered SVG icons by source, and act as the
namespace of the icons belonging to them. WordPress core registers the
`core` collection, while themes and plugins register their own with
`wp_register_icon_collection()`. Because collections only exist for the
duration of a request, they cannot be created or deleted from the command
line.

**EXAMPLES**

    # List all icon collections
    $ wp icon collection list
    +------+-----------+--------------------------+-------+
    | slug | label     | description              | count |
    +------+-----------+--------------------------+-------+
    | core | WordPress | Default icon collection. | 88    |
    +------+-----------+--------------------------+-------+

    # List the icons of a collection
    $ wp icon list --collection=core





### wp icon collection get

Gets details about a registered icon collection.

~~~
wp icon collection get <slug> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<slug>
		Icon collection slug.

	[--field=<field>]
		Instead of returning the whole collection, returns the value of a single field.

	[--fields=<fields>]
		Limit the output to specific fields. Defaults to all fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for the specified collection:

* slug
* label
* description
* count

**EXAMPLES**

    # Get details of a specific collection
    $ wp icon collection get core
    +-------------+--------------------------+
    | Field       | Value                    |
    +-------------+--------------------------+
    | slug        | core                     |
    | label       | WordPress                |
    | description | Default icon collection. |
    | count       | 88                       |
    +-------------+--------------------------+

    # Get the label field only
    $ wp icon collection get core --field=label
    WordPress



### wp icon collection is-registered

Checks if an icon collection is registered.

~~~
wp icon collection is-registered <slug>
~~~

**OPTIONS**

	<slug>
		Icon collection slug.

**EXAMPLES**

    # Bash script for checking if an icon collection is registered, with fallback.

    if wp icon collection is-registered core 2>/dev/null; then
        # Icon collection is registered. Do something.
    else
        # Fallback if collection is not registered.
    fi



### wp icon collection list

Lists registered icon collections.

~~~
wp icon collection list [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	[--field=<field>]
		Prints the value of a single field for each collection.

	[--fields=<fields>]
		Limit the output to specific collection fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - yaml
		  - ids
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each collection:

* slug
* label
* description
* count

**EXAMPLES**

    # List all icon collections
    $ wp icon collection list
    +------+-----------+--------------------------+-------+
    | slug | label     | description              | count |
    +------+-----------+--------------------------+-------+
    | core | WordPress | Default icon collection. | 88    |
    +------+-----------+--------------------------+-------+

    # List collections in JSON format
    $ wp icon collection list --fields=slug,label --format=json
    [{"slug":"core","label":"WordPress"}]



### wp icon get

Gets details about a registered icon.

~~~
wp icon get <name> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<name>
		Namespaced icon name, in the form "collection/icon-name".

	[--field=<field>]
		Instead of returning the whole icon, returns the value of a single field.

	[--fields=<fields>]
		Limit the output to specific fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for the specified icon:

* name
* label
* collection
* content

This field is optionally available:

* file_path

**EXAMPLES**

    # Get details of a specific icon
    $ wp icon get core/plus --fields=name,label,collection
    +------------+-----------+
    | Field      | Value     |
    +------------+-----------+
    | name       | core/plus |
    | label      | Plus      |
    | collection | core      |
    +------------+-----------+

    # Get the SVG markup of an icon, as it was registered
    $ wp icon get core/plus --field=content
    <svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 24 24">
        <path d="M11 12.5V17.5H12.5V12.5H17.5V11H12.5V6H11V11H6V12.5H11Z" />
    </svg>

    # Find out where an icon is loaded from
    $ wp icon get core/plus --field=file_path
    /var/www/html/wp-includes/images/icon-library/plus.svg



### wp icon is-registered

Checks if an icon is registered.

~~~
wp icon is-registered <name>
~~~

**OPTIONS**

	<name>
		Namespaced icon name, in the form "collection/icon-name".

**EXAMPLES**

    # Bash script for checking if an icon is registered, with fallback.

    if wp icon is-registered core/plus 2>/dev/null; then
        # Icon is registered. Do something.
    else
        # Fallback if icon is not registered.
    fi



### wp icon list

Lists registered icons.

~~~
wp icon list [--collection=<slug>] [--search=<term>] [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	[--collection=<slug>]
		Only list icons belonging to the given collection.

	[--search=<term>]
		Only list icons whose name or label matches the given term.

	[--field=<field>]
		Prints the value of a single field for each icon.

	[--fields=<fields>]
		Limit the output to specific icon fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - yaml
		  - ids
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each icon:

* name
* label
* collection

These fields are optionally available:

* content
* file_path

**EXAMPLES**

    # List all icons of a specific collection
    $ wp icon list --collection=core
    +-----------------+------------+------------+
    | name            | label      | collection |
    +-----------------+------------+------------+
    | core/arrow-down | Arrow Down | core       |
    | core/plus       | Plus       | core       |
    +-----------------+------------+------------+

    # Search for icons by name or label
    $ wp icon list --search=arrow-down --field=name
    core/arrow-down-left
    core/arrow-down-right
    core/arrow-down

    # Count the icons of a collection
    $ wp icon list --collection=core --format=count
    88



### wp icon render

Renders the SVG markup of a registered icon.

~~~
wp icon render <name> [--size=<size>] [--class=<class>] [--label=<label>]
~~~

Unlike `wp icon get <name> --field=content`, which prints the icon as it
was registered, this applies the same sizing and accessibility attributes
that WordPress applies when rendering the icon on the front end.

**OPTIONS**

	<name>
		Namespaced icon name, in the form "collection/icon-name".

	[--size=<size>]
		Width and height of the icon in pixels. Pass "none" to leave the
		intrinsic dimensions of the SVG untouched.
		---
		default: 24
		---

	[--class=<class>]
		Additional CSS class names, separated by spaces.

	[--label=<label>]
		Accessible label for the icon. Without it, the icon is rendered as
		decorative and hidden from assistive technology.

**EXAMPLES**

    # Render an icon at its default size of 24 pixels
    $ wp icon render core/plus
    <svg aria-hidden="true" focusable="false" height="24" width="24" xmlns="http://www.w3.org/2000/svg" viewbox="0 0 24 24">
        <path d="M11 12.5V17.5H12.5V12.5H17.5V11H12.5V6H11V11H6V12.5H11Z" />
    </svg>

    # Render a larger icon with a CSS class and an accessible label
    $ wp icon render core/plus --size=48 --class=my-icon --label="Add item" > plus.svg

    # Keep the intrinsic dimensions of the SVG
    $ wp icon render core/plus --size=none



### wp menu

Lists, creates, assigns, and deletes the active theme's navigation menus.

~~~
wp menu
~~~

See the [Navigation Menus](https://developer.wordpress.org/themes/functionality/navigation-menus/) reference in the Theme Handbook.

**EXAMPLES**

    # Create a new menu
    $ wp menu create "My Menu"
    Success: Created menu 200.

    # List existing menus
    $ wp menu list
    +---------+----------+----------+-----------+-------+
    | term_id | name     | slug     | locations | count |
    +---------+----------+----------+-----------+-------+
    | 200     | My Menu  | my-menu  |           | 0     |
    | 177     | Top Menu | top-menu | primary   | 7     |
    +---------+----------+----------+-----------+-------+

    # Create a new menu link item
    $ wp menu item add-custom my-menu Apple http://apple.com --porcelain
    1922

    # Assign the 'my-menu' menu to the 'primary' location
    $ wp menu location assign my-menu primary
    Success: Assigned location primary to menu my-menu.



### wp menu create

Creates a new menu.

~~~
wp menu create <menu-name> [--porcelain]
~~~

**OPTIONS**

	<menu-name>
		A descriptive name for the menu.

	[--porcelain]
		Output just the new menu id.

**EXAMPLES**

    $ wp menu create "My Menu"
    Success: Created menu 200.



### wp menu delete

Deletes one or more menus.

~~~
wp menu delete <menu>...
~~~

**OPTIONS**

	<menu>...
		The name, slug, or term ID for the menu(s).

**EXAMPLES**

    $ wp menu delete "My Menu"
    Deleted menu 'My Menu'.
    Success: Deleted 1 of 1 menus.



### wp menu item

List, add, and delete items associated with a menu.

~~~
wp menu item
~~~

**EXAMPLES**

    # Add an existing post to an existing menu
    $ wp menu item add-post sidebar-menu 33 --title="Custom Test Post"
    Success: Menu item added.

    # Create a new menu link item
    $ wp menu item add-custom sidebar-menu Apple http://apple.com
    Success: Menu item added.

    # Delete menu item
    $ wp menu item delete 45
    Success: Deleted 1 of 1 menu items.





### wp menu item add-custom

Adds a custom menu item.

~~~
wp menu item add-custom <menu> <title> <link> [--description=<description>] [--attr-title=<attr-title>] [--target=<target>] [--classes=<classes>] [--position=<position>] [--parent-id=<parent-id>] [--porcelain]
~~~

**OPTIONS**

	<menu>
		The name, slug, or term ID for the menu.

	<title>
		Title for the link.

	<link>
		Target URL for the link.

	[--description=<description>]
		Set a custom description for the menu item.

	[--attr-title=<attr-title>]
		Set a custom title attribute for the menu item.

	[--target=<target>]
		Set a custom link target for the menu item.

	[--classes=<classes>]
		Set a custom link classes for the menu item.

	[--position=<position>]
		Specify the position of this menu item.

	[--parent-id=<parent-id>]
		Make this menu item a child of another menu item.

	[--porcelain]
		Output just the new menu item id.

**EXAMPLES**

    $ wp menu item add-custom sidebar-menu Apple http://apple.com
    Success: Menu item added.



### wp menu item add-post

Adds a post as a menu item.

~~~
wp menu item add-post <menu> <post-id> [--title=<title>] [--link=<link>] [--description=<description>] [--attr-title=<attr-title>] [--target=<target>] [--classes=<classes>] [--position=<position>] [--parent-id=<parent-id>] [--porcelain]
~~~

**OPTIONS**

	<menu>
		The name, slug, or term ID for the menu.

	<post-id>
		Post ID to add to the menu.

	[--title=<title>]
		Set a custom title for the menu item.

	[--link=<link>]
		Set a custom url for the menu item.

	[--description=<description>]
		Set a custom description for the menu item.

	[--attr-title=<attr-title>]
		Set a custom title attribute for the menu item.

	[--target=<target>]
		Set a custom link target for the menu item.

	[--classes=<classes>]
		Set a custom link classes for the menu item.

	[--position=<position>]
		Specify the position of this menu item.

	[--parent-id=<parent-id>]
		Make this menu item a child of another menu item.

	[--porcelain]
		Output just the new menu item id.

**EXAMPLES**

    $ wp menu item add-post sidebar-menu 33 --title="Custom Test Post"
    Success: Menu item added.



### wp menu item add-term

Adds a taxonomy term as a menu item.

~~~
wp menu item add-term <menu> <taxonomy> <term-id> [--title=<title>] [--link=<link>] [--description=<description>] [--attr-title=<attr-title>] [--target=<target>] [--classes=<classes>] [--position=<position>] [--parent-id=<parent-id>] [--porcelain]
~~~

**OPTIONS**

	<menu>
		The name, slug, or term ID for the menu.

	<taxonomy>
		Taxonomy of the term to be added.

	<term-id>
		Term ID of the term to be added.

	[--title=<title>]
		Set a custom title for the menu item.

	[--link=<link>]
		Set a custom url for the menu item.

	[--description=<description>]
		Set a custom description for the menu item.

	[--attr-title=<attr-title>]
		Set a custom title attribute for the menu item.

	[--target=<target>]
		Set a custom link target for the menu item.

	[--classes=<classes>]
		Set a custom link classes for the menu item.

	[--position=<position>]
		Specify the position of this menu item.

	[--parent-id=<parent-id>]
		Make this menu item a child of another menu item.

	[--porcelain]
		Output just the new menu item id.

**EXAMPLES**

    $ wp menu item add-term sidebar-menu post_tag 24
    Success: Menu item added.



### wp menu item delete

Deletes one or more items from a menu.

~~~
wp menu item delete <db-id>...
~~~

**OPTIONS**

	<db-id>...
		Database ID for the menu item(s).

**EXAMPLES**

    $ wp menu item delete 45
    Success: Deleted 1 of 1 menu items.



### wp menu item get

Gets details about a menu item.

~~~
wp menu item get <db-id> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<db-id>
		Database ID for the menu item.

	[--field=<field>]
		Instead of returning the whole menu item, returns the value of a single field.

	[--fields=<fields>]
		Limit the output to specific fields. Defaults to db_id, type, title, link, position.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**AVAILABLE FIELDS**

These fields are available:

* db_id
* type
* title
* link
* position
* menu_item_parent
* object_id
* object
* type_label
* target
* attr_title
* description
* classes
* xfn

**EXAMPLES**

    # Get details about a menu item with ID 45
    $ wp menu item get 45
    +-------------+----------------------------------+
    | Field       | Value                            |
    +-------------+----------------------------------+
    | db_id       | 45                               |
    | type        | custom                           |
    | title       | WordPress                        |
    | link        | https://wordpress.org            |
    | position    | 1                                |
    +-------------+----------------------------------+

    # Get a specific field from a menu item
    $ wp menu item get 45 --field=title
    WordPress

    # Get menu item data in JSON format
    $ wp menu item get 45 --format=json
    {"db_id":45,"type":"custom","title":"WordPress","link":"https://wordpress.org","position":1}



### wp menu item list

Gets a list of items associated with a menu.

~~~
wp menu item list <menu> [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<menu>
		The name, slug, or term ID for the menu.

	[--fields=<fields>]
		Limit the output to specific object fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - ids
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each menu item:

* db_id
* type
* title
* link
* position

These fields are optionally available:

* menu_item_parent
* object_id
* object
* type
* type_label
* target
* attr_title
* description
* classes
* xfn

**EXAMPLES**

    $ wp menu item list main-menu
    +-------+-----------+-------------+---------------------------------+----------+
    | db_id | type      | title       | link                            | position |
    +-------+-----------+-------------+---------------------------------+----------+
    | 5     | custom    | Home        | http://example.com              | 1        |
    | 6     | post_type | Sample Page | http://example.com/sample-page/ | 2        |
    +-------+-----------+-------------+---------------------------------+----------+



### wp menu item update

Updates a menu item.

~~~
wp menu item update <db-id> [--title=<title>] [--link=<link>] [--description=<description>] [--attr-title=<attr-title>] [--target=<target>] [--classes=<classes>] [--position=<position>] [--parent-id=<parent-id>]
~~~

**OPTIONS**

	<db-id>
		Database ID for the menu item.

	[--title=<title>]
		Set a custom title for the menu item.

	[--link=<link>]
		Set a custom url for the menu item.

	[--description=<description>]
		Set a custom description for the menu item.

	[--attr-title=<attr-title>]
		Set a custom title attribute for the menu item.

	[--target=<target>]
		Set a custom link target for the menu item.

	[--classes=<classes>]
		Set a custom link classes for the menu item.

	[--position=<position>]
		Specify the position of this menu item.

	[--parent-id=<parent-id>]
		Make this menu item a child of another menu item.

**EXAMPLES**

    $ wp menu item update 45 --title=WordPress --link='http://wordpress.org' --target=_blank --position=2
    Success: Menu item updated.



### wp menu list

Gets a list of menus.

~~~
wp menu list [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	[--fields=<fields>]
		Limit the output to specific object fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - ids
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each menu:

* term_id
* name
* slug
* count

These fields are optionally available:

* term_group
* term_taxonomy_id
* taxonomy
* description
* parent
* locations

**EXAMPLES**

    $ wp menu list
    +---------+----------+----------+-----------+-------+
    | term_id | name     | slug     | locations | count |
    +---------+----------+----------+-----------+-------+
    | 200     | My Menu  | my-menu  |           | 0     |
    | 177     | Top Menu | top-menu | primary   | 7     |
    +---------+----------+----------+-----------+-------+



### wp menu location

Assigns, removes, and lists a menu's locations.

~~~
wp menu location
~~~

**EXAMPLES**

    # List available menu locations
    $ wp menu location list
    +----------+-------------------+
    | location | description       |
    +----------+-------------------+
    | primary  | Primary Menu      |
    | social   | Social Links Menu |
    +----------+-------------------+

    # Assign the 'primary-menu' menu to the 'primary' location
    $ wp menu location assign primary-menu primary
    Success: Assigned location primary to menu primary-menu.

    # Remove the 'primary-menu' menu from the 'primary' location
    $ wp menu location remove primary-menu primary
    Success: Removed location from menu.





### wp menu location assign

Assigns a location to a menu.

~~~
wp menu location assign <menu> <location>
~~~

**OPTIONS**

	<menu>
		The name, slug, or term ID for the menu.

	<location>
		Location's slug.

**EXAMPLES**

    $ wp menu location assign primary-menu primary
    Success: Assigned location primary to menu primary-menu.



### wp menu location list

Lists locations for the current theme.

~~~
wp menu location list [--format=<format>]
~~~

**OPTIONS**

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - yaml
		  - ids
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each location:

* name
* description

**EXAMPLES**

    $ wp menu location list
    +----------+-------------------+
    | location | description       |
    +----------+-------------------+
    | primary  | Primary Menu      |
    | social   | Social Links Menu |
    +----------+-------------------+



### wp menu location remove

Removes a location from a menu.

~~~
wp menu location remove <menu> <location>
~~~

**OPTIONS**

	<menu>
		The name, slug, or term ID for the menu.

	<location>
		Location's slug.

**EXAMPLES**

    $ wp menu location remove primary-menu primary
    Success: Removed location from menu.



### wp network

Perform network-wide operations.

~~~
wp network
~~~

**EXAMPLES**

    # Get a list of super-admins
    $ wp network meta get 1 site_admins
    array (
      0 => 'supervisor',
    )



### wp network meta

Gets, adds, updates, deletes, and lists network custom fields.

~~~
wp network meta
~~~

**EXAMPLES**

    # Get a list of super-admins
    $ wp network meta get 1 site_admins
    array (
      0 => 'supervisor',
    )



### wp network meta add

Add a meta field.

~~~
wp network meta add <id> <key> [<value>] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to create.

	[<value>]
		The value of the meta field. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp network meta delete

Delete a meta field.

~~~
wp network meta delete <id> [<key>] [<value>] [--all]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	[<key>]
		The name of the meta field to delete.

	[<value>]
		The value to delete. If omitted, all rows with key will deleted.

	[--all]
		Delete all meta for the object.



### wp network meta get

Get meta field value.

~~~
wp network meta get <id> <key> [--single] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to get.

	[--single]
		Whether to return a single value.

	[--format=<format>]
		Get value in a particular format.
		---
		default: var_export
		options:
		  - var_export
		  - json
		  - yaml
		---



### wp network meta list

List all metadata associated with an object.

~~~
wp network meta list <id> [--keys=<keys>] [--fields=<fields>] [--format=<format>] [--orderby=<fields>] [--order=<order>] [--unserialize]
~~~

**OPTIONS**

	<id>
		ID for the object.

	[--keys=<keys>]
		Limit output to metadata of specific keys.

	[--fields=<fields>]
		Limit the output to specific row fields. Defaults to id,meta_key,meta_value.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		  - count
		---

	[--orderby=<fields>]
		Set orderby which field.
		---
		default: id
		options:
		 - id
		 - meta_key
		 - meta_value
		---

	[--order=<order>]
		Set ascending or descending order.
		---
		default: asc
		options:
		 - asc
		 - desc
		---

	[--unserialize]
		Unserialize meta_value output.



### wp network meta patch

Update a nested value for a meta field.

~~~
wp network meta patch <action> <id> <key> <key-path>... [<value>] [--format=<format>]
~~~

**OPTIONS**

	<action>
		Patch action to perform.
		---
		options:
		  - insert
		  - update
		  - delete
		---

	<id>
		The ID of the object.

	<key>
		The name of the meta field to update.

	<key-path>...
		The name(s) of the keys within the value to locate the value to patch.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp network meta pluck

Get a nested value from a meta field.

~~~
wp network meta pluck <id> <key> <key-path>... [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to get.

	<key-path>...
		The name(s) of the keys within the value to locate the value to pluck.

	[--format=<format>]
		The output format of the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		  - yaml



### wp network meta update

Update a meta field.

~~~
wp network meta update <id> <key> [<value>] [--format=<format>]
~~~

**Alias:** `set`

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to update.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp option

Retrieves and sets site options, including plugin and WordPress settings.

~~~
wp option
~~~

See the [Plugin Settings API](https://developer.wordpress.org/plugins/settings/settings-api/) and the [Theme Options](https://developer.wordpress.org/themes/customize-api/) for more information on adding customized options.

**COMMON OPTIONS**

These are some of the most commonly used WordPress options:

* `siteurl` - Site URL, e.g. http://example.com
* `blogname` - Site title
* `blogdescription` - Site tagline
* `admin_email` - Administration email address
* `default_role` - Default role for new users
* `timezone_string` - Local timezone, e.g. "America/New_York"
* `home` - Home URL, e.g. http://example.com
* `blog_public` - Discourage search engines when set to 0

For the full list of available options, see the [Option Reference](https://developer.wordpress.org/apis/options/).

**EXAMPLES**

    # Get site URL.
    $ wp option get siteurl
    http://example.com

    # Add option.
    $ wp option add my_option foobar
    Success: Added 'my_option' option.

    # Update option.
    $ wp option update my_option '{"foo": "bar"}' --format=json
    Success: Updated 'my_option' option.

    # Delete option.
    $ wp option delete my_option
    Success: Deleted 'my_option' option.



### wp option add

Adds a new option value.

~~~
wp option add <key> [<value>] [--format=<format>] [--autoload=<autoload>]
~~~

Errors if the option already exists.

**OPTIONS**

	<key>
		The name of the option to add.

	[<value>]
		The value of the option to add. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---

	[--autoload=<autoload>]
		Should this option be automatically loaded.
		---
		options:
		  - 'on'
		  - 'off'
		  - 'yes'
		  - 'no'
		---

**EXAMPLES**

    # Create an option by reading a JSON file.
    $ wp option add my_option --format=json < config.json
    Success: Added 'my_option' option.



### wp option delete

Deletes an option.

~~~
wp option delete <key>...
~~~

**OPTIONS**

	<key>...
		Key for the option.

**EXAMPLES**

    # Delete an option.
    $ wp option delete my_option
    Success: Deleted 'my_option' option.

    # Delete multiple options.
    $ wp option delete option_one option_two option_three
    Success: Deleted 'option_one' option.
    Success: Deleted 'option_two' option.
    Warning: Could not delete 'option_three' option. Does it exist?



### wp option get

Gets the value for an option.

~~~
wp option get <key> [--format=<format>]
~~~

**OPTIONS**

	<key>
		Key for the option.

	[--format=<format>]
		Get value in a particular format.
		---
		default: var_export
		options:
		  - var_export
		  - json
		  - yaml
		---

**EXAMPLES**

    # Get option.
    $ wp option get home
    http://example.com

    # Get blog description.
    $ wp option get blogdescription
    A random blog description

    # Get blog name
    $ wp option get blogname
    A random blog name

    # Get admin email.
    $ wp option get admin_email
    someone@example.com

    # Get option in JSON format.
    $ wp option get active_plugins --format=json
    {"0":"dynamically-dynamic-sidebar\/dynamically-dynamic-sidebar.php","1":"monster-widget\/monster-widget.php","2":"show-current-template\/show-current-template.php","3":"theme-check\/theme-check.php","5":"wordpress-importer\/wordpress-importer.php"}



### wp option list

Lists options and their values.

~~~
wp option list [--search=<pattern>] [--exclude=<pattern>] [--autoload=<value>] [--transients] [--unserialize] [--field=<field>] [--fields=<fields>] [--format=<format>] [--orderby=<fields>] [--order=<order>]
~~~

**OPTIONS**

	[--search=<pattern>]
		Use wildcards ( * and ? ) to match option name.

	[--exclude=<pattern>]
		Pattern to exclude. Use wildcards ( * and ? ) to match option name.

	[--autoload=<value>]
		Match only autoload options when value is on, and only not-autoload option when off.

	[--transients]
		List only transients. Use `--no-transients` to ignore all transients.

	[--unserialize]
		Unserialize option values in output.

	[--field=<field>]
		Prints the value of a single field.

	[--fields=<fields>]
		Limit the output to specific object fields.

	[--format=<format>]
		The serialization format for the value. total_bytes displays the total size of matching options in bytes.
		---
		default: table
		options:
		  - table
		  - json
		  - csv
		  - count
		  - yaml
		  - total_bytes
		---

	[--orderby=<fields>]
		Set orderby which field.
		---
		default: option_id
		options:
		 - option_id
		 - option_name
		 - option_value
		---

	[--order=<order>]
		Set ascending or descending order.
		---
		default: asc
		options:
		 - asc
		 - desc
		---

**AVAILABLE FIELDS**

This field will be displayed by default for each matching option:

* option_name
* option_value

These fields are optionally available:

* autoload
* size_bytes

**EXAMPLES**

    # Get the total size of all autoload options.
    $ wp option list --autoload=on --format=total_bytes
    33198

    # Find biggest transients.
    $ wp option list --search="*_transient_*" --fields=option_name,size_bytes | sort -n -k 2 | tail
    option_name size_bytes
    _site_transient_timeout_theme_roots 10
    _site_transient_theme_roots 76
    _site_transient_update_themes   181
    _site_transient_update_core 808
    _site_transient_update_plugins  6645

    # List all options beginning with "i2f_".
    $ wp option list --search="i2f_*"
    +-------------+--------------+
    | option_name | option_value |
    +-------------+--------------+
    | i2f_version | 0.1.0        |
    +-------------+--------------+

    # Delete all options beginning with "theme_mods_".
    $ wp option list --search="theme_mods_*" --field=option_name | xargs -I % wp option delete %
    Success: Deleted 'theme_mods_twentysixteen' option.
    Success: Deleted 'theme_mods_twentyfifteen' option.
    Success: Deleted 'theme_mods_twentyfourteen' option.



### wp option patch

Updates a nested value in an option.

~~~
wp option patch <action> <key> <key-path>... [<value>] [--format=<format>]
~~~

**OPTIONS**

	<action>
		Patch action to perform.
		---
		options:
		  - insert
		  - update
		  - delete
		---

	<key>
		The option name.

	<key-path>...
		The name(s) of the keys within the value to locate the value to patch.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---

**EXAMPLES**

    # Add 'bar' to the 'foo' key on an option with name 'option_name'
    $ wp option patch insert option_name foo bar
    Success: Updated 'option_name' option.

    # Update the value of 'foo' key to 'new' on an option with name 'option_name'
    $ wp option patch update option_name foo new
    Success: Updated 'option_name' option.

    # Set nested value of 'bar' key to value we have in the patch file on an option with name 'option_name'.
    $ wp option patch update option_name foo bar < patch
    Success: Updated 'option_name' option.

    # Update the value for the key 'not-a-key' which is not exist on an option with name 'option_name'.
    $ wp option patch update option_name foo not-a-key new-value
    Error: No data exists for key "not-a-key"

    # Update the value for the key 'foo' without passing value on an option with name 'option_name'.
    $ wp option patch update option_name foo
    Error: Please provide value to update.

    # Delete the nested key 'bar' under 'foo' key on an option with name 'option_name'.
    $ wp option patch delete option_name foo bar
    Success: Updated 'option_name' option.



### wp option pluck

Gets a nested value from an option.

~~~
wp option pluck <key> <key-path>... [--format=<format>]
~~~

**OPTIONS**

	<key>
		The option name.

	<key-path>...
		The name(s) of the keys within the value to locate the value to pluck.

	[--format=<format>]
		The output format of the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		  - yaml
		---



### wp option update

Updates an option value.

~~~
wp option update <key> [<value>] [--autoload=<autoload>] [--format=<format>]
~~~

**Alias:** `set`

**OPTIONS**

	<key>
		The name of the option to update.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--autoload=<autoload>]
		Should this option be automatically loaded.
		---
		options:
		  - 'on'
		  - 'off'
		  - 'yes'
		  - 'no'
		---

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---

**EXAMPLES**

    # Update an option by reading from a file.
    $ wp option update my_option < value.txt
    Success: Updated 'my_option' option.

    # Update one option on multiple sites using xargs.
    $ wp site list --field=url | xargs -n1 -I {} sh -c 'wp --url={} option update my_option my_value'
    Success: Updated 'my_option' option.
    Success: Updated 'my_option' option.

    # Update site blog name.
    $ wp option update blogname "Random blog name"
    Success: Updated 'blogname' option.

    # Update site blog description.
    $ wp option update blogdescription "Some random blog description"
    Success: Updated 'blogdescription' option.

    # Update admin email address.
    $ wp option update admin_email someone@example.com
    Success: Updated 'admin_email' option.

    # Set the default role.
    $ wp option update default_role author
    Success: Updated 'default_role' option.

    # Set the timezone string.
    $ wp option update timezone_string "America/New_York"
    Success: Updated 'timezone_string' option.



### wp option set-autoload

Sets the 'autoload' value for an option.

~~~
wp option set-autoload <key> <autoload>
~~~

**OPTIONS**

	<key>
		The name of the option to set 'autoload' for.

	<autoload>
		Should this option be automatically loaded.
		---
		options:
		  - 'on'
		  - 'off'
		  - 'yes'
		  - 'no'
		---

**EXAMPLES**

    # Set the 'autoload' value for an option.
    $ wp option set-autoload abc_options no
    Success: Updated autoload value for 'abc_options' option.



### wp option get-autoload

Gets the 'autoload' value for an option.

~~~
wp option get-autoload <key>
~~~

**OPTIONS**

	<key>
		The name of the option to get 'autoload' of.

**EXAMPLES**

    # Get the 'autoload' value for an option.
    $ wp option get-autoload blogname
    yes



### wp post

Manages posts, content, and meta.

~~~
wp post
~~~

**EXAMPLES**

    # Create a new post.
    $ wp post create --post_type=post --post_title='A sample post'
    Success: Created post 123.

    # Update an existing post.
    $ wp post update 123 --post_status=draft
    Success: Updated post 123.

    # Delete an existing post.
    $ wp post delete 123
    Success: Trashed post 123.



### wp post create

Creates a new post.

~~~
wp post create [--post_author=<post_author>] [--post_date=<post_date>] [--post_date_gmt=<post_date_gmt>] [--post_content=<post_content>] [--post_content_filtered=<post_content_filtered>] [--post_title=<post_title>] [--post_excerpt=<post_excerpt>] [--post_status=<post_status>] [--post_type=<post_type>] [--comment_status=<comment_status>] [--ping_status=<ping_status>] [--post_password=<post_password>] [--post_name=<post_name>] [--from-post=<post_id>] [--to_ping=<to_ping>] [--pinged=<pinged>] [--post_modified=<post_modified>] [--post_modified_gmt=<post_modified_gmt>] [--post_parent=<post_parent>] [--menu_order=<menu_order>] [--post_mime_type=<post_mime_type>] [--guid=<guid>] [--post_category=<post_category>] [--tags_input=<tags_input>] [--tax_input=<tax_input>] [--meta_input=<meta_input>] [--page_template=<page_template>] [--import_id=<import_id>] [<file>] [--<field>=<value>] [--edit] [--porcelain]
~~~

**OPTIONS**

	[--post_author=<post_author>]
		The ID of the user who added the post. Default is the current user ID.

	[--post_date=<post_date>]
		The date of the post. Default is the current time.

	[--post_date_gmt=<post_date_gmt>]
		The date of the post in the GMT timezone. Default is the value of $post_date.

	[--post_content=<post_content>]
		The post content. Default empty.

	[--post_content_filtered=<post_content_filtered>]
		The filtered post content. Default empty.

	[--post_title=<post_title>]
		The post title. Default empty.

	[--post_excerpt=<post_excerpt>]
		The post excerpt. Default empty.

	[--post_status=<post_status>]
		The post status. Default 'draft'.

	[--post_type=<post_type>]
		The post type. Default 'post'.

	[--comment_status=<comment_status>]
		Whether the post can accept comments. Accepts 'open' or 'closed'. Default is the value of 'default_comment_status' option.

	[--ping_status=<ping_status>]
		Whether the post can accept pings. Accepts 'open' or 'closed'. Default is the value of 'default_ping_status' option.

	[--post_password=<post_password>]
		The password to access the post. Default empty.

	[--post_name=<post_name>]
		The post name. Default is the sanitized post title when creating a new post.

	[--from-post=<post_id>]
		Post id of a post to be duplicated.

	[--to_ping=<to_ping>]
		Space or carriage return-separated list of URLs to ping. Default empty.

	[--pinged=<pinged>]
		Space or carriage return-separated list of URLs that have been pinged. Default empty.

	[--post_modified=<post_modified>]
		The date when the post was last modified. Default is the current time.

	[--post_modified_gmt=<post_modified_gmt>]
		The date when the post was last modified in the GMT timezone. Default is the current time.

	[--post_parent=<post_parent>]
		Set this for the post it belongs to, if any. Default 0.

	[--menu_order=<menu_order>]
		The order the post should be displayed in. Default 0.

	[--post_mime_type=<post_mime_type>]
		The mime type of the post. Default empty.

	[--guid=<guid>]
		Global Unique ID for referencing the post. Default empty.

	[--post_category=<post_category>]
		Array of category names, slugs, or IDs. Defaults to value of the 'default_category' option.

	[--tags_input=<tags_input>]
		Array of tag names, slugs, or IDs. Default empty.

	[--tax_input=<tax_input>]
		Array of taxonomy terms keyed by their taxonomy name. Default empty.

		Note: In WordPress core, this normally requires a user context to satisfy capability checks. WP-CLI bypasses this for convenience. See https://core.trac.wordpress.org/ticket/19373

	[--meta_input=<meta_input>]
		Array in JSON format of post meta values keyed by their post meta key. Default empty.

	[--page_template=<page_template>]
		Page template to use.

	[--import_id=<import_id>]
		The post ID to be used when inserting a new post. If specified, must not
		match any existing post ID.

	[<file>]
		Read post content from <file>. If this value is present, the
		    `--post_content` argument will be ignored.

		Passing `-` as the filename will cause post content to
		be read from STDIN.

	[--<field>=<value>]
		Associative args for the new post. See wp_insert_post().

	[--edit]
		Immediately open system's editor to write or edit post content.

		If content is read from a file, from STDIN, or from the `--post_content`
		argument, that text will be loaded into the editor.

	[--porcelain]
		Output just the new post id.

**EXAMPLES**

    # Create post and schedule for future
    $ wp post create --post_type=post --post_title='A future post' --post_status=future --post_date='2030-12-01 07:00:00'
    Success: Created post 1921.

    # Create post with content from given file
    $ wp post create ./post-content.txt --post_category=201,345 --post_title='Post from file'
    Success: Created post 1922.

    # Create a post with multiple meta values.
    $ wp post create --post_title='A post' --post_content='Just a small post.' --meta_input='{"key1":"value1","key2":"value2"}'
    Success: Created post 1923.

    # Create a duplicate post from existing posts.
    $ wp post create --from-post=123 --post_title='Different Title'
    Success: Created post 2350.



### wp post delete

Deletes an existing post.

~~~
wp post delete <id>... [--force] [--defer-term-counting]
~~~

**OPTIONS**

	<id>...
		One or more IDs of posts to delete.

	[--force]
		Skip the trash bin.

	[--defer-term-counting]
		Recalculate term count in batch, for a performance boost.

**EXAMPLES**

    # Delete post skipping trash
    $ wp post delete 123 --force
    Success: Deleted post 123.

    # Delete multiple posts
    $ wp post delete 123 456 789
    Success: Trashed post 123.
    Success: Trashed post 456.
    Success: Trashed post 789.

    # Delete all pages
    $ wp post delete $(wp post list --post_type='page' --format=ids)
    Success: Trashed post 1164.
    Success: Trashed post 1186.

    # Delete all posts in the trash
    $ wp post delete $(wp post list --post_status=trash --format=ids)
    Success: Deleted post 1268.
    Success: Deleted post 1294.



### wp post edit

Launches system editor to edit post content.

~~~
wp post edit <id>
~~~

**OPTIONS**

	<id>
		The ID of the post to edit.

**EXAMPLES**

    # Launch system editor to edit post
    $ wp post edit 123



### wp post exists

Verifies whether a post exists.

~~~
wp post exists <id>
~~~

Displays a success message if the post does exist.

**OPTIONS**

	<id>
		The ID of the post to check.

**EXAMPLES**

    # The post exists.
    $ wp post exists 1337
    Success: Post with ID 1337 exists.
    $ echo $?
    0

    # The post does not exist.
    $ wp post exists 10000
    $ echo $?
    1



### wp post generate

Generates some posts.

~~~
wp post generate [--count=<number>] [--post_type=<type>] [--post_status=<status>] [--post_title=<post_title>] [--post_author=<login>] [--post_date=<yyyy-mm-dd-hh-ii-ss>] [--post_date_gmt=<yyyy-mm-dd-hh-ii-ss>] [--post_content] [--max_depth=<number>] [--format=<format>]
~~~

Creates a specified number of new posts with dummy data.

**OPTIONS**

	[--count=<number>]
		How many posts to generate?
		---
		default: 100
		---

	[--post_type=<type>]
		The type of the generated posts.
		---
		default: post
		---

	[--post_status=<status>]
		The status of the generated posts.
		---
		default: publish
		---

	[--post_title=<post_title>]
		The post title.
		---
		default:
		---

	[--post_author=<login>]
		The author of the generated posts.
		---
		default:
		---

	[--post_date=<yyyy-mm-dd-hh-ii-ss>]
		The date of the post. Default is the current time.

	[--post_date_gmt=<yyyy-mm-dd-hh-ii-ss>]
		The date of the post in the GMT timezone. Default is the value of --post_date.

	[--post_content]
		If set, the command reads the post_content from STDIN.

	[--max_depth=<number>]
		For hierarchical post types, generate child posts down to a certain depth.
		---
		default: 1
		---

	[--format=<format>]
		Render output in a particular format.
		---
		default: progress
		options:
		  - progress
		  - ids
		---

**EXAMPLES**

    # Generate posts.
    $ wp post generate --count=10 --post_type=page --post_date=1999-01-04
    Generating posts  100% [================================================] 0:01 / 0:04

    # Generate posts with fetched content.
    $ curl -N https://loripsum.net/api/5 | wp post generate --post_content --count=10
      % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                     Dload  Upload   Total   Spent    Left  Speed
    100  2509  100  2509    0     0    616      0  0:00:04  0:00:04 --:--:--   616
    Generating posts  100% [================================================] 0:01 / 0:04

    # Add meta to every generated posts.
    $ wp post generate --format=ids | xargs -d ' ' -I % wp post meta add % foo bar
    Success: Added custom field.
    Success: Added custom field.
    Success: Added custom field.



### wp post get

Gets details about a post.

~~~
wp post get <id> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the post to get.

	[--field=<field>]
		Instead of returning the whole post, returns the value of a single field.

	[--fields=<fields>]
		Limit the output to specific fields. Defaults to all fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**EXAMPLES**

    # Save the post content to a file
    $ wp post get 123 --field=content > file.txt

    # Get the block version of a post (1 = has blocks, 0 = no blocks)
    # Requires WordPress 5.0+.
    $ wp post get 123 --field=block_version
    1



### wp post list

Gets a list of posts.

~~~
wp post list [--<field>=<value>] [--p=<id>|ID] [--title=<title>|post_title] [--name=<slug>|post_name] [--author=<author>|post_author] [--author_name=<author_name>] [--cat=<cat>] [--category_name=<category_name>] [--tag=<tag>] [--post_type=<post_type>] [--post_status=<post_status>] [--post_parent=<post_parent>] [--post_mime_type=<post_mime_type>] [--menu_order=<menu_order>] [--comment_status=<comment_status>] [--ping_status=<ping_status>] [--comment_count=<comment_count>] [--s=<string>] [--year=<year>] [--monthnum=<monthnum>] [--day=<day>] [--hour=<hour>] [--minute=<minute>] [--second=<second>] [--m=<yearmonth>] [--w=<week>] [--meta_key=<meta_key>] [--meta_value=<meta_value>] [--orderby=<orderby>] [--order=<order>] [--post__in=<ids>] [--post__not_in=<ids>] [--post_name__in=<slugs>] [--post_parent__in=<ids>] [--post_parent__not_in=<ids>] [--author__in=<ids>] [--author__not_in=<ids>] [--category__in=<ids>] [--category__and=<ids>] [--category__not_in=<ids>] [--tag_id=<tag_id>] [--tag__in=<ids>] [--tag__and=<ids>] [--tag__not_in=<ids>] [--tag_slug__in=<slugs>] [--tag_slug__and=<slugs>] [--page_id=<page_id>] [--pagename=<pagename>] [--attachment_id=<attachment_id>] [--date_query=<json>] [--meta_query=<json>] [--tax_query=<json>] [--meta_compare=<meta_compare>] [--sentence=<sentence>] [--exact=<exact>] [--search_columns=<columns>] [--perm=<perm>] [--posts_per_page=<number>] [--paged=<paged>] [--offset=<offset>] [--nopaging=<nopaging>] [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

Display posts based on all arguments supported by [WP_Query()](https://developer.wordpress.org/reference/classes/wp_query/).
Only shows post types marked as post by default.

**OPTIONS**

	[--<field>=<value>]
		One or more args to pass to WP_Query. The arguments below are the ones
		that filter on what this command displays; anything else WP_Query accepts
		still works and is documented with WP_Query itself.

	[--p=<id>|ID]
		Filter by post ID. `--ID` is the name of the column this filters and is
		accepted as an alias.

	[--title=<title>|post_title]
		Filter by post title, matched in full. `--post_title` is the name of the
		column this filters and is accepted as an alias.

	[--name=<slug>|post_name]
		Filter by post slug. `--post_name` is the name of the column this filters
		and is accepted as an alias.
		Note: this makes the query a single-post one, and WP_Query returns a draft
		from one of those only to a user who can edit it. WP-CLI runs as no user
		unless the global `--user` argument says otherwise, so pass that to filter
		drafts by slug.

	[--author=<author>|post_author]
		Filter by the ID of the post's author. `--post_author` is the name of the
		column this filters and is accepted as an alias.

	[--author_name=<author_name>]
		Filter by the 'user_nicename' of the post's author.

	[--cat=<cat>]
		Filter by category ID. Accepts a comma-separated list to match any of
		them, and a negative ID excludes that category instead.

	[--category_name=<category_name>]
		Filter by category slug.

	[--tag=<tag>]
		Filter by tag slug. Accepts a comma-separated list to match any of them,
		or a '+'-separated list to require all of them.

	[--post_type=<post_type>]
		Filter by post type. Defaults to 'post'. Accepts a comma-separated list,
		or 'any' for every type registered without 'exclude_from_search'.

	[--post_status=<post_status>]
		Filter by post status. Defaults to 'any', which is every status
		registered without 'exclude_from_search' - so trashed and auto-draft posts
		are left out until asked for by name, e.g. `--post_status=trash`.

	[--post_parent=<post_parent>]
		Filter by the ID of the parent post.

	[--post_mime_type=<post_mime_type>]
		Filter by MIME type. Only attachments carry one.

	[--menu_order=<menu_order>]
		Filter by menu order.

	[--comment_status=<comment_status>]
		Filter by comment status. Accepts 'open' or 'closed'.

	[--ping_status=<ping_status>]
		Filter by ping status. Accepts 'open' or 'closed'.

	[--comment_count=<comment_count>]
		Filter by number of comments.

	[--s=<string>]
		Only list the posts matching this search term.

	[--year=<year>]
		Filter by four-digit year, e.g. 2024.

	[--monthnum=<monthnum>]
		Filter by month number, 1 to 12.

	[--day=<day>]
		Filter by day of the month, 1 to 31.

	[--hour=<hour>]
		Filter by hour, 0 to 23.

	[--minute=<minute>]
		Filter by minute, 0 to 59.

	[--second=<second>]
		Filter by second, 0 to 59.

	[--m=<yearmonth>]
		Filter by year and month together, e.g. 202401.

	[--w=<week>]
		Filter by week of the year, 0 to 53.

	[--meta_key=<meta_key>]
		Filter by posts having this meta key. Pair it with `--meta_value` to
		filter on the value as well.

	[--meta_value=<meta_value>]
		Filter by this meta value. Needs `--meta_key` to say which key it
		belongs to.

	[--orderby=<orderby>]
		Order the results by this field. Accepts what WP_Query accepts, e.g.
		'date', 'title', 'ID', 'menu_order', 'rand', or 'meta_value' alongside
		`--meta_key`.

	[--order=<order>]
		Direction to order by. Accepts 'ASC' or 'DESC'.

	[--post__in=<ids>]
		Only list the posts with these IDs (comma-separated).

	[--post__not_in=<ids>]
		Exclude the posts with these IDs (comma-separated).

	[--post_name__in=<slugs>]
		Only list the posts with these slugs (comma-separated). Unlike `--name`
		this is not a single-post query, so it reaches drafts as well.

	[--post_parent__in=<ids>]
		Only list the posts whose parent is one of these IDs (comma-separated).

	[--post_parent__not_in=<ids>]
		Exclude the posts whose parent is one of these IDs (comma-separated).

	[--author__in=<ids>]
		Only list the posts by these author IDs (comma-separated).

	[--author__not_in=<ids>]
		Exclude the posts by these author IDs (comma-separated).

	[--category__in=<ids>]
		Only list the posts in these category IDs (comma-separated).

	[--category__and=<ids>]
		Only list the posts in all of these category IDs (comma-separated).

	[--category__not_in=<ids>]
		Exclude the posts in these category IDs (comma-separated).

	[--tag_id=<tag_id>]
		Filter by tag ID.

	[--tag__in=<ids>]
		Only list the posts with these tag IDs (comma-separated).

	[--tag__and=<ids>]
		Only list the posts with all of these tag IDs (comma-separated).

	[--tag__not_in=<ids>]
		Exclude the posts with these tag IDs (comma-separated).

	[--tag_slug__in=<slugs>]
		Only list the posts with these tag slugs (comma-separated).

	[--tag_slug__and=<slugs>]
		Only list the posts with all of these tag slugs (comma-separated).

	[--page_id=<page_id>]
		Filter by page ID. Needs `--post_type=page` to match anything.

	[--pagename=<pagename>]
		Filter by page slug. Needs `--post_type=page` to match anything.

	[--attachment_id=<attachment_id>]
		Filter by attachment ID. Needs `--post_type=attachment` to match
		anything.

	[--date_query=<json>]
		Filter by a date query, given as JSON. See WP_Date_Query.

	[--meta_query=<json>]
		Filter by a meta query, given as JSON. See WP_Meta_Query.

	[--tax_query=<json>]
		Filter by a taxonomy query, given as JSON. See WP_Tax_Query.

	[--meta_compare=<meta_compare>]
		Operator to test `--meta_value` with, e.g. '=', '!=', '>' or 'LIKE'.

	[--sentence=<sentence>]
		Match `--s` as one phrase rather than as separate words. Accepts 1 or 0.

	[--exact=<exact>]
		Match `--s` against the whole column rather than part of it. Accepts 1
		or 0.

	[--search_columns=<columns>]
		Comma-separated list of columns `--s` looks in. Accepts 'post_title',
		'post_excerpt' and 'post_content'. Needs WordPress 6.2 or later.

	[--perm=<perm>]
		Filter by what the current user may do with the post. Accepts
		'readable' or 'editable'; pair it with the global `--user` argument,
		since WP-CLI is no user by default.

	[--posts_per_page=<number>]
		How many posts to return. Defaults to -1, meaning every post.

	[--paged=<paged>]
		Which page of results to return, counted in `--posts_per_page` steps.

	[--offset=<offset>]
		How many posts to skip. Needs `--posts_per_page` set to something other
		than -1, which otherwise takes precedence.

	[--nopaging=<nopaging>]
		Return every post, ignoring `--posts_per_page`. Accepts 1 or 0.

	[--field=<field>]
		Prints the value of a single field for each post.

	[--fields=<fields>]
		Limit the output to specific object fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - ids
		  - json
		  - count
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each post:

* ID
* post_title
* post_name
* post_date
* post_status

These fields are optionally available:

* post_author
* post_date_gmt
* post_content
* post_excerpt
* comment_status
* ping_status
* post_password
* to_ping
* pinged
* post_modified
* post_modified_gmt
* post_content_filtered
* post_parent
* guid
* menu_order
* post_type
* post_mime_type
* comment_count
* url

**EXAMPLES**

    # List post
    $ wp post list --field=ID
    568
    829
    1329
    1695

    # List posts in JSON
    $ wp post list --post_type=post --posts_per_page=5 --format=json
    [{"ID":1,"post_title":"Hello world!","post_name":"hello-world","post_date":"2015-06-20 09:00:10","post_status":"publish"},{"ID":1178,"post_title":"Markup: HTML Tags and Formatting","post_name":"markup-html-tags-and-formatting","post_date":"2013-01-11 20:22:19","post_status":"draft"}]

    # List all pages
    $ wp post list --post_type=page --fields=post_title,post_status
    +-------------+-------------+
    | post_title  | post_status |
    +-------------+-------------+
    | Sample Page | publish     |
    +-------------+-------------+

    # List ids of all pages and posts
    $ wp post list --post_type=page,post --format=ids
    15 25 34 37 198

    # List given posts
    $ wp post list --post__in=1,3
    +----+--------------+-------------+---------------------+-------------+
    | ID | post_title   | post_name   | post_date           | post_status |
    +----+--------------+-------------+---------------------+-------------+
    | 3  | Lorem Ipsum  | lorem-ipsum | 2016-06-01 14:34:36 | publish     |
    | 1  | Hello world! | hello-world | 2016-06-01 14:31:12 | publish     |
    +----+--------------+-------------+---------------------+-------------+

    # List given post by a specific author
    $ wp post list --author=2
    +----+-------------------+-------------------+---------------------+-------------+
    | ID | post_title        | post_name         | post_date           | post_status |
    +----+-------------------+-------------------+---------------------+-------------+
    | 14 | New documentation | new-documentation | 2021-06-18 21:05:11 | publish     |
    +----+-------------------+-------------------+---------------------+-------------+



### wp post meta

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

~~~
wp post meta
~~~

**EXAMPLES**

    # Set post meta
    $ wp post meta set 123 _wp_page_template about.php
    Success: Updated custom field '_wp_page_template'.

    # Get post meta
    $ wp post meta get 123 _wp_page_template
    about.php

    # Update post meta
    $ wp post meta update 123 _wp_page_template contact.php
    Success: Updated custom field '_wp_page_template'.

    # Delete post meta
    $ wp post meta delete 123 _wp_page_template
    Success: Deleted custom field.





### wp post meta add

Add a meta field.

~~~
wp post meta add <id> <key> [<value>] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to create.

	[<value>]
		The value of the meta field. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp post meta clean-duplicates

Cleans up duplicate post meta values on a post.

~~~
wp post meta clean-duplicates <id> <key>
~~~

**OPTIONS**

	<id>
		ID of the post to clean.

	<key>
		Meta key to clean up.

**EXAMPLES**

    # Delete duplicate post meta.
    wp post meta clean-duplicates 1234 enclosure
    Success: Cleaned up duplicate 'enclosure' meta values.



### wp post meta delete

Delete a meta field.

~~~
wp post meta delete <id> [<key>] [<value>] [--all]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	[<key>]
		The name of the meta field to delete.

	[<value>]
		The value to delete. If omitted, all rows with key will deleted.

	[--all]
		Delete all meta for the object.



### wp post meta get

Get meta field value.

~~~
wp post meta get <id> <key> [--single] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to get.

	[--single]
		Whether to return a single value.

	[--format=<format>]
		Get value in a particular format.
		---
		default: var_export
		options:
		  - var_export
		  - json
		  - yaml
		---



### wp post meta list

List all metadata associated with an object.

~~~
wp post meta list <id> [--keys=<keys>] [--fields=<fields>] [--format=<format>] [--orderby=<fields>] [--order=<order>] [--unserialize]
~~~

**OPTIONS**

	<id>
		ID for the object.

	[--keys=<keys>]
		Limit output to metadata of specific keys.

	[--fields=<fields>]
		Limit the output to specific row fields. Defaults to id,meta_key,meta_value.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		  - count
		---

	[--orderby=<fields>]
		Set orderby which field.
		---
		default: id
		options:
		 - id
		 - meta_key
		 - meta_value
		---

	[--order=<order>]
		Set ascending or descending order.
		---
		default: asc
		options:
		 - asc
		 - desc
		---

	[--unserialize]
		Unserialize meta_value output.



### wp post meta patch

Update a nested value for a meta field.

~~~
wp post meta patch <action> <id> <key> <key-path>... [<value>] [--format=<format>]
~~~

**OPTIONS**

	<action>
		Patch action to perform.
		---
		options:
		  - insert
		  - update
		  - delete
		---

	<id>
		The ID of the object.

	<key>
		The name of the meta field to update.

	<key-path>...
		The name(s) of the keys within the value to locate the value to patch.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp post meta pluck

Get a nested value from a meta field.

~~~
wp post meta pluck <id> <key> <key-path>... [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to get.

	<key-path>...
		The name(s) of the keys within the value to locate the value to pluck.

	[--format=<format>]
		The output format of the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		  - yaml



### wp post meta update

Update a meta field.

~~~
wp post meta update <id> <key> [<value>] [--format=<format>]
~~~

**Alias:** `set`

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to update.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp post revision

Manages post revisions.

~~~
wp post revision
~~~

**EXAMPLES**

    # Restore a post revision
    $ wp post revision restore 123
    Success: Restored revision 123.

    # Show diff between two revisions
    $ wp post revision diff 123 456





### wp post revision diff

Shows the difference between two revisions.

~~~
wp post revision diff <from> [<to>] [--field=<field>]
~~~

**OPTIONS**

	<from>
		The 'from' revision ID or post ID.

	[<to>]
		The 'to' revision ID or post ID. If not provided, compares with the current post.

	[--field=<field>]
		Compare specific field(s). Default: post_content

**EXAMPLES**

    # Show diff between two revisions
    $ wp post revision diff 123 456

    # Show diff between a revision and the current post
    $ wp post revision diff 123



### wp post revision prune

Deletes old post revisions.

~~~
wp post revision prune [<post-id>...] [--latest=<limit>] [--earliest=<limit>] [--yes]
~~~

**OPTIONS**

	[<post-id>...]
		One or more post IDs to prune revisions for. If not provided, prunes revisions for all posts.

	[--latest=<limit>]
		Keep only the latest N revisions per post. Older revisions will be deleted.

	[--earliest=<limit>]
		Keep only the earliest N revisions per post. Newer revisions will be deleted.

	[--yes]
		Skip confirmation prompt.

**EXAMPLES**

    # Delete all but the latest 5 revisions for post 123
    $ wp post revision prune 123 --latest=5
    Success: Deleted 3 revisions for post 123.

    # Delete all but the latest 5 revisions for all posts
    $ wp post revision prune --latest=5
    Success: Deleted 150 revisions across 30 posts.

    # Delete all but the earliest 2 revisions for posts 123 and 456
    $ wp post revision prune 123 456 --earliest=2
    Success: Deleted 5 revisions for post 123.
    Success: Deleted 3 revisions for post 456.



### wp post revision restore

Restores a post revision.

~~~
wp post revision restore <revision_id>
~~~

**OPTIONS**

	<revision_id>
		The revision ID to restore.

**EXAMPLES**

    # Restore a post revision
    $ wp post revision restore 123
    Success: Restored revision 123.



### wp post term

Adds, updates, removes, and lists post terms.

~~~
wp post term
~~~

**EXAMPLES**

    # Set category post term `test` to the post ID 123
    $ wp post term set 123 test category
    Success: Set term.

    # Set category post terms `test` and `apple` to the post ID 123
    $ wp post term set 123 test apple category
    Success: Set terms.

    # List category post terms for the post ID 123
    $ wp post term list 123 category --fields=term_id,slug
    +---------+-------+
    | term_id | slug  |
    +---------+-------+
    | 2       | apple |
    | 3       | test  |
    +----------+------+

    # Remove category post terms `test` and `apple` for the post ID 123
    $ wp post term remove 123 category test apple
    Success: Removed terms.





### wp post term add

Add a term to an object.

~~~
wp post term add <id> <taxonomy> <term>... [--by=<field>]
~~~

Append the term to the existing set of terms on the object.

**OPTIONS**

	<id>
		The ID of the object.

	<taxonomy>
		The name of the taxonomy type to be added.

	<term>...
		The slug of the term or terms to be added.

	[--by=<field>]
		Explicitly handle the term value as a slug or id.
		---
		default: slug
		options:
		  - slug
		  - id
		---



### wp post term list

List all terms associated with an object.

~~~
wp post term list <id> <taxonomy>... [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<id>
		ID for the object.

	<taxonomy>...
		One or more taxonomies to list.

	[--field=<field>]
		Prints the value of a single field for each term.

	[--fields=<fields>]
		Limit the output to specific row fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		  - count
		  - ids
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each term:

* term_id
* name
* slug
* taxonomy

These fields are optionally available:

* term_taxonomy_id
* description
* term_group
* parent
* count



### wp post term remove

Remove a term from an object.

~~~
wp post term remove <id> <taxonomy> [<term>...] [--by=<field>] [--all]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<taxonomy>
		The name of the term's taxonomy.

	[<term>...]
		The slug of the term or terms to be removed from the object.

	[--by=<field>]
		Explicitly handle the term value as a slug or id.
		---
		default: slug
		options:
		  - slug
		  - id
		---

	[--all]
		Remove all terms from the object.



### wp post term set

Set object terms.

~~~
wp post term set <id> <taxonomy> <term>... [--by=<field>]
~~~

Replaces existing terms on the object.

**OPTIONS**

	<id>
		The ID of the object.

	<taxonomy>
		The name of the taxonomy type to be updated.

	<term>...
		The slug of the term or terms to be updated.

	[--by=<field>]
		Explicitly handle the term value as a slug or id.
		---
		default: slug
		options:
		  - slug
		  - id
		---



### wp post update

Updates one or more existing posts.

~~~
wp post update <id>... [--post_author=<post_author>] [--post_date=<post_date>] [--post_date_gmt=<post_date_gmt>] [--post_content=<post_content>] [--post_content_filtered=<post_content_filtered>] [--post_title=<post_title>] [--post_excerpt=<post_excerpt>] [--post_status=<post_status>] [--post_type=<post_type>] [--comment_status=<comment_status>] [--ping_status=<ping_status>] [--post_password=<post_password>] [--post_name=<post_name>] [--to_ping=<to_ping>] [--pinged=<pinged>] [--post_modified=<post_modified>] [--post_modified_gmt=<post_modified_gmt>] [--post_parent=<post_parent>] [--menu_order=<menu_order>] [--post_mime_type=<post_mime_type>] [--guid=<guid>] [--post_category=<post_category>] [--tags_input=<tags_input>] [--tax_input=<tax_input>] [--meta_input=<meta_input>] [--page_template=<page_template>] [<file>] --<field>=<value> [--defer-term-counting]
~~~

**OPTIONS**

	<id>...
		One or more IDs of posts to update.

	[--post_author=<post_author>]
		The ID of the user who added the post. Default is the current user ID.

	[--post_date=<post_date>]
		The date of the post. Default is the current time.

	[--post_date_gmt=<post_date_gmt>]
		The date of the post in the GMT timezone. Default is the value of $post_date.

	[--post_content=<post_content>]
		The post content. Default empty.

	[--post_content_filtered=<post_content_filtered>]
		The filtered post content. Default empty.

	[--post_title=<post_title>]
		The post title. Default empty.

	[--post_excerpt=<post_excerpt>]
		The post excerpt. Default empty.

	[--post_status=<post_status>]
		The post status. Default 'draft'.

	[--post_type=<post_type>]
		The post type. Default 'post'.

	[--comment_status=<comment_status>]
		Whether the post can accept comments. Accepts 'open' or 'closed'. Default is the value of 'default_comment_status' option.

	[--ping_status=<ping_status>]
		Whether the post can accept pings. Accepts 'open' or 'closed'. Default is the value of 'default_ping_status' option.

	[--post_password=<post_password>]
		The password to access the post. Default empty.

	[--post_name=<post_name>]
		The post name. Default is the sanitized post title when creating a new post.

	[--to_ping=<to_ping>]
		Space or carriage return-separated list of URLs to ping. Default empty.

	[--pinged=<pinged>]
		Space or carriage return-separated list of URLs that have been pinged. Default empty.

	[--post_modified=<post_modified>]
		The date when the post was last modified. Default is the current time.

	[--post_modified_gmt=<post_modified_gmt>]
		The date when the post was last modified in the GMT timezone. Default is the current time.

	[--post_parent=<post_parent>]
		Set this for the post it belongs to, if any. Default 0.

	[--menu_order=<menu_order>]
		The order the post should be displayed in. Default 0.

	[--post_mime_type=<post_mime_type>]
		The mime type of the post. Default empty.

	[--guid=<guid>]
		Global Unique ID for referencing the post. Default empty.

	[--post_category=<post_category>]
		Array of category names, slugs, or IDs. Defaults to value of the 'default_category' option.

	[--tags_input=<tags_input>]
		Array of tag names, slugs, or IDs. Default empty.

	[--tax_input=<tax_input>]
		Array of taxonomy terms keyed by their taxonomy name. Default empty.

		Note: In WordPress core, this normally requires a user context to satisfy capability checks. WP-CLI bypasses this for convenience. See https://core.trac.wordpress.org/ticket/19373

	[--meta_input=<meta_input>]
		Array in JSON format of post meta values keyed by their post meta key. Default empty.

	[--page_template=<page_template>]
		Page template to use.

	[<file>]
		Read post content from <file>. If this value is present, the
		    `--post_content` argument will be ignored.

		Passing `-` as the filename will cause post content to
		be read from STDIN.

	--<field>=<value>
		One or more fields to update. See wp_insert_post().

	[--defer-term-counting]
		Recalculate term count in batch, for a performance boost.

**EXAMPLES**

    $ wp post update 123 --post_name=something --post_status=draft
    Success: Updated post 123.

    # Update a post with multiple meta values.
    $ wp post update 123 --meta_input='{"key1":"value1","key2":"value2"}'
    Success: Updated post 123.

    # Update multiple posts at once.
    $ wp post update 123 456 --post_author=789
    Success: Updated post 123.
    Success: Updated post 456.

    # Update all posts of a given post type at once.
    $ wp post update $(wp post list --post_type=page --format=ids) --post_author=123
    Success: Updated post 123.
    Success: Updated post 456.



### wp post url-to-id

Gets the post ID for a given URL.

~~~
wp post url-to-id <url>
~~~

**OPTIONS**

	<url>
		The URL of the post to get.

**EXAMPLES**

    # Get post ID by URL
    $ wp post url-to-id https://example.com/?p=1
    1



### wp post has-blocks

Checks if a post contains any blocks.

~~~
wp post has-blocks <id>
~~~

Exits with return code 0 if the post contains blocks,
or return code 1 if it does not.

**OPTIONS**

	<id>
		The ID of the post to check.

**EXAMPLES**

    # Check if post contains blocks.
    $ wp post has-blocks 123
    Success: Post 123 contains blocks.

    # Check a classic (non-block) post.
    $ wp post has-blocks 456
    Error: Post 456 does not contain blocks.

    # Use in a shell conditional.
    $ if wp post has-blocks 123 2>/dev/null; then
    >   echo "Post uses blocks"
    > fi



### wp post has-block

Checks if a post contains a specific block type.

~~~
wp post has-block <id> <block-name>
~~~

Exits with return code 0 if the post contains the specified block,
or return code 1 if it does not.

**OPTIONS**

	<id>
		The ID of the post to check.

	<block-name>
		The block type name to check for (e.g., 'core/paragraph').

**EXAMPLES**

    # Check if post contains a paragraph block.
    $ wp post has-block 123 core/paragraph
    Success: Post 123 contains block 'core/paragraph'.

    # Check for a heading block.
    $ wp post has-block 123 core/heading
    Success: Post 123 contains block 'core/heading'.

    # Check for a block that doesn't exist.
    $ wp post has-block 123 core/gallery
    Error: Post 123 does not contain block 'core/gallery'.

    # Check for a custom block from a plugin.
    $ wp post has-block 123 my-plugin/custom-block



### wp post block

Manages blocks within post content.

~~~
wp post block
~~~

Provides commands for inspecting, manipulating, and managing
Gutenberg blocks in post content.

**EXAMPLES**

    # List all blocks in a post.
    $ wp post block list 123
    +------------------+-------+
    | blockName        | count |
    +------------------+-------+
    | core/paragraph   | 2     |
    | core/heading     | 1     |
    +------------------+-------+

    # Parse blocks in a post to JSON.
    $ wp post block parse 123 --format=json

    # Insert a paragraph block.
    $ wp post block insert 123 core/paragraph --content="Hello World"





### wp post block clone

Clones a block within a post.

~~~
wp post block clone <id> <source-index> [--position=<position>] [--porcelain]
~~~

Duplicates an existing block and inserts it at a specified position.

**OPTIONS**

	<id>
		The ID of the post.

	<source-index>
		Index of the block to clone (0-indexed).

	[--position=<position>]
		Where to insert the cloned block. Accepts 'after', 'before', 'start', 'end', or a numeric index.
		---
		default: after
		---

	[--porcelain]
		Output just the new block index.

**EXAMPLES**

    # Clone a block and insert immediately after it (default).
    $ wp post block clone 123 2
    Success: Cloned block to index 3 in post 123.

    # Clone the first block and insert immediately before it.
    $ wp post block clone 123 0 --position=before
    Success: Cloned block to index 0 in post 123.

    # Clone a block and insert at the end of the post.
    $ wp post block clone 123 0 --position=end
    Success: Cloned block to index 5 in post 123.

    # Clone a block and insert at the start of the post.
    $ wp post block clone 123 3 --position=start
    Success: Cloned block to index 0 in post 123.

    # Clone and get just the new block index for scripting.
    $ wp post block clone 123 1 --porcelain
    2

    # Duplicate the hero section (first block) at the end for a footer.
    $ wp post block clone 123 0 --position=end
    Success: Cloned block to index 10 in post 123.



### wp post block count

Counts blocks across multiple posts.

~~~
wp post block count [<id>...] [--block=<block-name>] [--post-type=<type>] [--post-status=<status>] [--format=<format>]
~~~

Analyzes block usage across posts for site-wide reporting.

**OPTIONS**

	[<id>...]
		Optional post IDs. If not specified, queries all posts.

	[--block=<block-name>]
		Only count specific block type.

	[--post-type=<type>]
		Limit to specific post type(s). Comma-separated.
		---
		default: post,page
		---

	[--post-status=<status>]
		Post status to include.
		---
		default: publish
		---

	[--format=<format>]
		Output format.
		---
		default: table
		options:
		  - table
		  - json
		  - csv
		  - yaml
		  - count
		---

**EXAMPLES**

    # Count all blocks across published posts and pages.
    $ wp post block count
    +------------------+-------+-------+
    | blockName        | count | posts |
    +------------------+-------+-------+
    | core/paragraph   | 1542  | 234   |
    | core/heading     | 523   | 198   |
    | core/image       | 312   | 156   |
    +------------------+-------+-------+

    # Count blocks in specific posts only.
    $ wp post block count 123 456 789
    +------------------+-------+-------+
    | blockName        | count | posts |
    +------------------+-------+-------+
    | core/paragraph   | 8     | 3     |
    | core/heading     | 3     | 2     |
    +------------------+-------+-------+

    # Count only paragraph blocks across the site.
    $ wp post block count --block=core/paragraph --format=count
    1542

    # Count blocks in a custom post type.
    $ wp post block count --post-type=product

    # Count blocks in multiple post types.
    $ wp post block count --post-type=post,page,product

    # Count blocks including drafts.
    $ wp post block count --post-status=draft

    # Get count as JSON for further processing.
    $ wp post block count --format=json
    [{"blockName":"core/paragraph","count":1542,"posts":234}]

    # Get total number of unique block types used.
    $ wp post block count --format=count
    15



### wp post block export

Exports block content to a file.

~~~
wp post block export <id> [--file=<file>] [--format=<format>] [--raw]
~~~

Exports blocks from a post to a file for backup or migration.

**OPTIONS**

	<id>
		The ID of the post to export blocks from.

	[--file=<file>]
		Output file path. If not specified, outputs to STDOUT.

	[--format=<format>]
		Export format.
		---
		default: json
		options:
		  - json
		  - yaml
		  - html
		---

	[--raw]
		Include innerHTML in JSON/YAML output.

**EXAMPLES**

    # Export blocks to a JSON file for backup.
    $ wp post block export 123 --file=blocks.json
    Success: Exported 5 blocks to blocks.json

    # Export blocks to STDOUT as JSON.
    $ wp post block export 123
    {
        "version": "1.0",
        "generator": "wp-cli/entity-command",
        "post_id": 123,
        "exported_at": "2024-12-10T12:00:00+00:00",
        "blocks": [...]
    }

    # Export as YAML format.
    $ wp post block export 123 --format=yaml
    version: "1.0"
    generator: wp-cli/entity-command
    blocks:
      - blockName: core/paragraph
        attrs: []

    # Export rendered HTML (final output, not block structure).
    $ wp post block export 123 --format=html --file=content.html
    Success: Exported 5 blocks to content.html

    # Export with raw innerHTML included for complete backup.
    $ wp post block export 123 --raw --file=blocks-full.json
    Success: Exported 5 blocks to blocks-full.json

    # Pipe export to another command.
    $ wp post block export 123 | jq '.blocks[].blockName'



### wp post block extract

Extracts data from blocks.

~~~
wp post block extract <id> [--block=<block-name>] [--index=<index>] [--attr=<attr>] [--content] [--format=<format>]
~~~

Extracts specific attribute values or content from blocks for scripting.

**OPTIONS**

	<id>
		The ID of the post.

	[--block=<block-name>]
		Filter by block type.

	[--index=<index>]
		Get from specific block index.

	[--attr=<attr>]
		Extract specific attribute value.

	[--content]
		Extract innerHTML content.

	[--format=<format>]
		Output format.
		---
		default: json
		options:
		  - json
		  - yaml
		  - csv
		  - ids
		---

**EXAMPLES**

    # Extract all image IDs from the post (one per line).
    $ wp post block extract 123 --block=core/image --attr=id --format=ids
    456
    789
    1024

    # Extract all image URLs as JSON array.
    $ wp post block extract 123 --block=core/image --attr=url --format=json
    ["https://example.com/img1.jpg","https://example.com/img2.jpg"]

    # Extract text content from all headings.
    $ wp post block extract 123 --block=core/heading --content --format=ids
    Introduction
    Getting Started
    Conclusion

    # Get the heading level from the first block.
    $ wp post block extract 123 --index=0 --attr=level --format=ids
    2

    # Extract all heading levels as CSV.
    $ wp post block extract 123 --block=core/heading --attr=level --format=csv
    2,3,3,2

    # Extract paragraph content as YAML.
    $ wp post block extract 123 --block=core/paragraph --content --format=yaml
    - "First paragraph text"
    - "Second paragraph text"

    # Get all button URLs for link checking.
    $ wp post block extract 123 --block=core/button --attr=url --format=ids
    https://example.com/signup
    https://example.com/learn-more

    # Extract cover block image IDs for media audit.
    $ wp post block extract 123 --block=core/cover --attr=id --format=json



### wp post block get

Gets a single block by index.

~~~
wp post block get <id> <index> [--raw] [--format=<format>]
~~~

Retrieves the full structure of a block at the specified position.

**OPTIONS**

	<id>
		The ID of the post.

	<index>
		The block index (0-indexed).

	[--raw]
		Include innerHTML in output.

	[--format=<format>]
		Render output in a particular format.
		---
		default: json
		options:
		  - json
		  - yaml
		---

**EXAMPLES**

    # Get the first block in a post.
    $ wp post block get 123 0
    {
        "blockName": "core/paragraph",
        "attrs": {},
        "innerBlocks": []
    }

    # Get the third block (index 2) with attributes.
    $ wp post block get 123 2
    {
        "blockName": "core/heading",
        "attrs": {
            "level": 2
        },
        "innerBlocks": []
    }

    # Get block as YAML format.
    $ wp post block get 123 1 --format=yaml
    blockName: core/image
    attrs:
      id: 456
      sizeSlug: large
    innerBlocks: []

    # Get block with raw HTML content included.
    $ wp post block get 123 0 --raw
    {
        "blockName": "core/paragraph",
        "attrs": {},
        "innerBlocks": [],
        "innerHTML": "<p>Hello World</p>",
        "innerContent": ["<p>Hello World</p>"]
    }



### wp post block import

Imports blocks from a file into a post.

~~~
wp post block import <id> [--file=<file>] [--position=<position>] [--replace] [--porcelain]
~~~

Imports blocks from a JSON or YAML file into a post's content.

**OPTIONS**

	<id>
		The ID of the post to import blocks into.

	[--file=<file>]
		Input file path. If not specified, reads from STDIN.

	[--position=<position>]
		Where to insert imported blocks. Accepts 'start', 'end', or a numeric index.
		---
		default: end
		---

	[--replace]
		Replace all existing blocks instead of appending.

	[--porcelain]
		Output just the number of blocks imported.

**EXAMPLES**

    # Import blocks from a JSON file, append to end of post.
    $ wp post block import 123 --file=blocks.json
    Success: Imported 5 blocks into post 123.

    # Import blocks at the beginning of the post.
    $ wp post block import 123 --file=blocks.json --position=start
    Success: Imported 5 blocks into post 123.

    # Replace all existing content with imported blocks.
    $ wp post block import 123 --file=blocks.json --replace
    Success: Imported 5 blocks into post 123.

    # Import from STDIN (piped from another command).
    $ cat blocks.json | wp post block import 123
    Success: Imported 5 blocks into post 123.

    # Copy blocks from one post to another.
    $ wp post block export 123 | wp post block import 456
    Success: Imported 5 blocks into post 456.

    # Import YAML format.
    $ wp post block import 123 --file=blocks.yaml
    Success: Imported 3 blocks into post 123.

    # Get just the count of imported blocks for scripting.
    $ wp post block import 123 --file=blocks.json --porcelain
    5



### wp post block insert

Inserts a block into a post at a specified position.

~~~
wp post block insert <id> <block-name> [--content=<content>] [--attrs=<attrs>] [--position=<position>] [--porcelain]
~~~

Adds a new block to the post content. By default, the block is
appended to the end of the post.

**OPTIONS**

	<id>
		The ID of the post to modify.

	<block-name>
		The block type name (e.g., 'core/paragraph').

	[--content=<content>]
		The inner content/HTML for the block.

	[--attrs=<attrs>]
		Block attributes as JSON.

	[--position=<position>]
		Position to insert the block (0-indexed). Use 'start' or 'end'.
		---
		default: end
		---

	[--porcelain]
		Output just the post ID.

**EXAMPLES**

    # Insert a paragraph block at the end of the post.
    $ wp post block insert 123 core/paragraph --content="Hello World"
    Success: Inserted block into post 123.

    # Insert a level-2 heading at the start.
    $ wp post block insert 123 core/heading --content="My Title" --attrs='{"level":2}' --position=start
    Success: Inserted block into post 123.

    # Insert an image block at position 2.
    $ wp post block insert 123 core/image --attrs='{"id":456,"url":"https://example.com/image.jpg"}' --position=2

    # Insert a separator block.
    $ wp post block insert 123 core/separator



### wp post block list

Lists blocks in a post with counts.

~~~
wp post block list <id> [--nested] [--format=<format>]
~~~

Displays a summary of block types used in the post and how many
times each block type appears.

**OPTIONS**

	<id>
		The ID of the post to analyze.

	[--nested]
		Include nested/inner blocks in the list.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		  - count
		---

**EXAMPLES**

    # List blocks with counts.
    $ wp post block list 123
    +------------------+-------+
    | blockName        | count |
    +------------------+-------+
    | core/paragraph   | 5     |
    | core/heading     | 2     |
    | core/image       | 1     |
    +------------------+-------+

    # List blocks as JSON.
    $ wp post block list 123 --format=json
    [{"blockName":"core/paragraph","count":5}]

    # Include nested blocks (e.g., blocks inside columns or groups).
    $ wp post block list 123 --nested

    # Get the number of unique block types.
    $ wp post block list 123 --format=count
    3



### wp post block move

Moves a block from one position to another.

~~~
wp post block move <id> <from-index> <to-index> [--porcelain]
~~~

Reorders blocks within the post by moving a block from one index to another.

**OPTIONS**

	<id>
		The ID of the post.

	<from-index>
		Current block index (0-indexed).

	<to-index>
		Target position index (0-indexed).

	[--porcelain]
		Output just the post ID.

**EXAMPLES**

    # Move the first block to the third position.
    $ wp post block move 123 0 2
    Success: Moved block from index 0 to index 2 in post 123.

    # Move the last block (index 4) to the beginning.
    $ wp post block move 123 4 0
    Success: Moved block from index 4 to index 0 in post 123.

    # Move a heading block from position 3 to position 1.
    $ wp post block move 123 3 1
    Success: Moved block from index 3 to index 1 in post 123.

    # Move block and get post ID for scripting.
    $ wp post block move 123 2 0 --porcelain
    123



### wp post block parse

Parses and displays the block structure of a post.

~~~
wp post block parse <id> [--raw] [--format=<format>]
~~~

Outputs the parsed block structure as JSON or YAML. By default,
innerHTML is stripped from the output for readability.

**OPTIONS**

	<id>
		The ID of the post to parse.

	[--raw]
		Include raw innerHTML in output.

	[--format=<format>]
		Render output in a particular format.
		---
		default: json
		options:
		  - json
		  - yaml
		---

**EXAMPLES**

    # Parse blocks to JSON.
    $ wp post block parse 123
    [
        {
            "blockName": "core/paragraph",
            "attrs": {}
        }
    ]

    # Parse blocks to YAML format.
    $ wp post block parse 123 --format=yaml
    -
      blockName: core/paragraph
      attrs: {  }

    # Parse blocks including raw HTML content.
    $ wp post block parse 123 --raw



### wp post block remove

Removes blocks from a post by name or index.

~~~
wp post block remove <id> [<block-name>] [--index=<index>] [--all] [--porcelain]
~~~

Removes one or more blocks from the post content. Blocks can be
removed by their type name or by their position index.

**OPTIONS**

	<id>
		The ID of the post to modify.

	[<block-name>]
		The block type name to remove (e.g., 'core/paragraph').

	[--index=<index>]
		Remove block at specific index (0-indexed). Can be comma-separated for multiple indices.

	[--all]
		Remove all blocks of the specified type.

	[--porcelain]
		Output just the number of blocks removed.

**EXAMPLES**

    # Remove the first block (index 0).
    $ wp post block remove 123 --index=0
    Success: Removed 1 block from post 123.

    # Remove the first paragraph block found.
    $ wp post block remove 123 core/paragraph
    Success: Removed 1 block from post 123.

    # Remove all paragraph blocks.
    $ wp post block remove 123 core/paragraph --all
    Success: Removed 5 blocks from post 123.

    # Remove blocks at multiple indices.
    $ wp post block remove 123 --index=0,2,4
    Success: Removed 3 blocks from post 123.

    # Remove all image blocks and get count.
    $ wp post block remove 123 core/image --all --porcelain
    2



### wp post block replace

Replaces blocks in a post.

~~~
wp post block replace <id> <old-block-name> <new-block-name> [--attrs=<attrs>] [--content=<content>] [--all] [--porcelain]
~~~

Replaces blocks of one type with blocks of another type. Can also
be used to update block attributes without changing the block type.

**OPTIONS**

	<id>
		The ID of the post to modify.

	<old-block-name>
		The block type name to replace.

	<new-block-name>
		The new block type name.

	[--attrs=<attrs>]
		New block attributes as JSON.

	[--content=<content>]
		New block content. Use '{content}' to preserve original content.

	[--all]
		Replace all matching blocks. By default, only the first match is replaced.

	[--porcelain]
		Output just the number of blocks replaced.

**EXAMPLES**

    # Replace the first paragraph block with a heading.
    $ wp post block replace 123 core/paragraph core/heading
    Success: Replaced 1 block in post 123.

    # Replace all paragraphs with preformatted blocks, keeping content.
    $ wp post block replace 123 core/paragraph core/preformatted --content='{content}' --all
    Success: Replaced 3 blocks in post 123.

    # Change all h2 headings to h3.
    $ wp post block replace 123 core/heading core/heading --attrs='{"level":3}' --all

    # Replace and get count for scripting.
    $ wp post block replace 123 core/quote core/pullquote --all --porcelain
    2



### wp post block render

Renders blocks from a post to HTML.

~~~
wp post block render <id> [--block=<block-name>]
~~~

Outputs the rendered HTML of blocks in a post. This uses WordPress's
block rendering system to produce the final HTML output.

**OPTIONS**

	<id>
		The ID of the post to render.

	[--block=<block-name>]
		Only render blocks of this type.

**EXAMPLES**

    # Render all blocks to HTML.
    $ wp post block render 123
    <p>Hello World</p>
    <h2>My Heading</h2>

    # Render only paragraph blocks.
    $ wp post block render 123 --block=core/paragraph
    <p>Hello World</p>

    # Render only heading blocks.
    $ wp post block render 123 --block=core/heading



### wp post block update

Updates a block's attributes or content by index.

~~~
wp post block update <id> <index> [--attrs=<attrs>] [--content=<content>] [--replace-attrs] [--porcelain]
~~~

Modifies a specific block without changing its type. For blocks where
attributes are reflected in HTML (like heading levels), the HTML is
automatically updated to match the new attributes.

**OPTIONS**

	<id>
		The ID of the post.

	<index>
		The block index to update (0-indexed).

	[--attrs=<attrs>]
		Block attributes as JSON. Merges with existing attributes by default.

	[--content=<content>]
		New innerHTML content for the block.

	[--replace-attrs]
		Replace all attributes instead of merging.

	[--porcelain]
		Output just the post ID.

**EXAMPLES**

    # Change a heading from h2 to h3.
    $ wp post block update 123 0 --attrs='{"level":3}'
    Success: Updated block at index 0 in post 123.

    # Add alignment to an existing paragraph (merges with existing attrs).
    $ wp post block update 123 1 --attrs='{"align":"center"}'
    Success: Updated block at index 1 in post 123.

    # Update the text content of a paragraph block.
    $ wp post block update 123 2 --content="<p>Updated paragraph text</p>"
    Success: Updated block at index 2 in post 123.

    # Update both attributes and content at once.
    $ wp post block update 123 0 --attrs='{"level":2}' --content="<h2>New Heading</h2>"
    Success: Updated block at index 0 in post 123.

    # Replace all attributes instead of merging (removes existing attrs).
    $ wp post block update 123 0 --attrs='{"level":4}' --replace-attrs
    Success: Updated block at index 0 in post 123.

    # Get just the post ID for scripting.
    $ wp post block update 123 0 --attrs='{"level":2}' --porcelain
    123

    # Use custom HTML sync logic via the wp_cli_post_block_update_html filter.
    # Use WP_CLI::add_wp_hook() in a file loaded with --require.
    $ wp post block update 123 0 --attrs='{"url":"https://example.com"}' --require=my-sync-filters.php
    Success: Updated block at index 0 in post 123.



### wp post-type

Retrieves details on the site's registered post types.

~~~
wp post-type
~~~

Get information on WordPress' built-in and the site's [custom post types](https://developer.wordpress.org/plugins/post-types/).

**EXAMPLES**

    # Get details about a post type
    $ wp post-type get page --fields=name,label,hierarchical --format=json
    {"name":"page","label":"Pages","hierarchical":true}

    # List post types with 'post' capability type
    $ wp post-type list --capability_type=post --fields=name,public
    +---------------+--------+
    | name          | public |
    +---------------+--------+
    | post          | 1      |
    | attachment    | 1      |
    | revision      |        |
    | nav_menu_item |        |
    +---------------+--------+



### wp post-type get

Gets details about a registered post type.

~~~
wp post-type get <post-type> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<post-type>
		Post type slug

	[--field=<field>]
		Instead of returning the whole taxonomy, returns the value of a single field.

	[--fields=<fields>]
		Limit the output to specific fields. Defaults to all fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for the specified post type:

* name
* label
* description
* hierarchical
* public
* capability_type
* labels
* cap
* supports

These fields are optionally available:

* count

**EXAMPLES**

    # Get details about the 'page' post type.
    $ wp post-type get page --fields=name,label,hierarchical --format=json
    {"name":"page","label":"Pages","hierarchical":true}



### wp post-type list

Lists registered post types.

~~~
wp post-type list [--<field>=<value>] [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	[--<field>=<value>]
		Filter by one or more fields (see get_post_types() first parameter for a list of available fields).

	[--field=<field>]
		Prints the value of a single field for each post type.

	[--fields=<fields>]
		Limit the output to specific post type fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each post type:

* name
* label
* description
* hierarchical
* public
* capability_type

These fields are optionally available:

* count

**EXAMPLES**

    # List registered post types
    $ wp post-type list --format=csv
    name,label,description,hierarchical,public,capability_type
    post,Posts,,,1,post
    page,Pages,,1,1,page
    attachment,Media,,,1,post
    revision,Revisions,,,,post
    nav_menu_item,"Navigation Menu Items",,,,post

    # List post types with 'post' capability type
    $ wp post-type list --capability_type=post --fields=name,public
    +---------------+--------+
    | name          | public |
    +---------------+--------+
    | post          | 1      |
    | attachment    | 1      |
    | revision      |        |
    | nav_menu_item |        |
    +---------------+--------+



### wp site

Creates, deletes, empties, moderates, and lists one or more sites on a multisite installation.

~~~
wp site
~~~

**EXAMPLES**

    # Create site
    $ wp site create --slug=example
    Success: Site 3 created: www.example.com/example/

    # Output a simple list of site URLs
    $ wp site list --field=url
    http://www.example.com/
    http://www.example.com/subdir/

    # Delete site
    $ wp site delete 123
    Are you sure you want to delete the 'http://www.example.com/example' site? [y/n] y
    Success: The site at 'http://www.example.com/example' was deleted.



### wp site activate

Activates one or more sites.

~~~
wp site activate [<id>...] [--slug=<slug>]
~~~

**OPTIONS**

	[<id>...]
		One or more IDs of sites to activate. If not provided, you must set the --slug parameter.

	[--slug=<slug>]
		Path of the site to be activated. Subdomain on subdomain installs, directory on subdirectory installs.

**EXAMPLES**

    $ wp site activate 123
    Success: Site 123 activated.

     $ wp site activate --slug=demo
     Success: Site 123 marked as activated.



### wp site archive

Archives one or more sites.

~~~
wp site archive [<id>...] [--slug=<slug>]
~~~

**OPTIONS**

	[<id>...]
		One or more IDs of sites to archive. If not provided, you must set the --slug parameter.

	[--slug=<slug>]
		Path of the site to archive. Subdomain on subdomain installs, directory on subdirectory installs.

**EXAMPLES**

    $ wp site archive 123
    Success: Site 123 archived.

    $ wp site archive --slug=demo
    Success: Site 123 archived.



### wp site create

Creates a site in a multisite installation.

~~~
wp site create [--slug=<slug>] [--site-url=<url>] [--title=<title>] [--email=<email>] [--network_id=<network-id>] [--private] [--porcelain]
~~~

**OPTIONS**

	[--slug=<slug>]
		Path for the new site. Subdomain on subdomain installs, directory on subdirectory installs.
		Required if --site-url is not provided.

	[--site-url=<url>]
		Full URL for the new site. Use this to specify a custom domain instead of the auto-generated one.
		For subdomain installs, this allows you to use a different base domain (e.g., 'http://site.example.com' instead of 'http://site.main.example.com').
		For subdirectory installs, this allows you to use a different path.
		If provided, --slug is optional and will be derived from the URL. If both --slug and --site-url are provided, --slug will be used as the base for internal operations (like user creation), while the domain/path from --site-url will be used for the actual site URL.

	[--title=<title>]
		Title of the new site. Default: prettified slug.

	[--email=<email>]
		Email for admin user. User will be created if none exists. Assignment to super admin if not included.

	[--network_id=<network-id>]
		Network to associate new site with. Defaults to current network (typically 1).

	[--private]
		If set, the new site will be non-public (not indexed)

	[--porcelain]
		If set, only the site id will be output on success.

**EXAMPLES**

    # Create a site with auto-generated domain
    $ wp site create --slug=example
    Success: Site 3 created: http://www.example.com/example/

    # Create a site with a custom domain (subdomain multisite)
    $ wp site create --site-url=http://site.example.com
    Success: Site 4 created: http://site.example.com/

    # Create a site with a custom subdirectory (subdirectory multisite)
    $ wp site create --site-url=http://example.com/custom/path/
    Success: Site 5 created: http://example.com/custom/path/



### wp site generate

Generate some sites.

~~~
wp site generate [--count=<number>] [--slug=<slug>] [--email=<email>] [--network_id=<network-id>] [--private] [--format=<format>]
~~~

Creates a specified number of new sites.

**OPTIONS**

	[--count=<number>]
		How many sites to generates?
		---
		default: 100
		---

	[--slug=<slug>]
		Path for the new site. Subdomain on subdomain installs, directory on subdirectory installs.

	[--email=<email>]
		Email for admin user. User will be created if none exists. Assignment to super admin if not included.

	[--network_id=<network-id>]
		Network to associate new site with. Defaults to current network (typically 1).

	[--private]
		If set, the new site will be non-public (not indexed)

	[--format=<format>]
		Render output in a particular format.
		---
		default: progress
		options:
		 - progress
		 - ids
		---

**EXAMPLES**

   # Generate 10 sites.
   $ wp site generate --count=10
   Generating sites  100% [================================================] 0:01 / 0:04



### wp site deactivate

Deactivates one or more sites.

~~~
wp site deactivate [<id>...] [--slug=<slug>]
~~~

**OPTIONS**

	[<id>...]
		One or more IDs of sites to deactivate. If not provided, you must set the --slug parameter.

	[--slug=<slug>]
		Path of the site to be deactivated. Subdomain on subdomain installs, directory on subdirectory installs.

**EXAMPLES**

    $ wp site deactivate 123
    Success: Site 123 deactivated.

    $ wp site deactivate --slug=demo
    Success: Site 123 deactivated.



### wp site delete

Deletes a site in a multisite installation.

~~~
wp site delete [<site-id>] [--slug=<slug>] [--yes] [--keep-tables] [--delete-tables-with-prefix]
~~~

**OPTIONS**

	[<site-id>]
		The id of the site to delete. If not provided, you must set the --slug parameter.

	[--slug=<slug>]
		Path of the site to be deleted. Subdomain on subdomain installs, directory on subdirectory installs.

	[--yes]
		Answer yes to the confirmation message.

	[--keep-tables]
		Delete the blog from the list, but don't drop its tables.

	[--delete-tables-with-prefix]
		Delete all tables with the site's database table prefix after deleting the site.

**EXAMPLES**

    $ wp site delete 123
    Are you sure you want to delete the http://www.example.com/example site? [y/n] y
    Success: The site at 'http://www.example.com/example' was deleted.



### wp site empty

Empties a site of its content (posts, comments, terms, links, and meta).

~~~
wp site empty [--uploads] [--yes]
~~~

Truncates posts, comments, terms, and links tables to empty a site of its
content. Doesn't affect site configuration (options) or users.

Flushes the object cache after emptying the site to ensure stale data
is not served. On a Multisite installation, this will flush the cache
for all sites.

To also empty custom database tables, you'll need to hook into command
execution:

```
WP_CLI::add_hook( 'after_invoke:site empty', function(){
    global $wpdb;
    foreach( array( 'p2p', 'p2pmeta' ) as $table ) {
        $table = $wpdb->$table;
        $wpdb->query( "TRUNCATE $table" );
    }
});
```

**OPTIONS**

	[--uploads]
		Also delete *all* files in the site's uploads directory.

	[--yes]
		Proceed to empty the site without a confirmation prompt.

**EXAMPLES**

    $ wp site empty
    Are you sure you want to empty the site at http://www.example.com of all posts, links, comments, and terms? [y/n] y
    Success: The site at 'http://www.example.com' was emptied.



### wp site get

Gets details about a site in a multisite installation.

~~~
wp site get <site> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<site>
		Site ID or URL of the site to get. For subdirectory sites, use the full URL (e.g., http://example.com/subdir/).

	[--field=<field>]
		Instead of returning the whole site, returns the value of a single field.

	[--fields=<fields>]
		Limit the output to specific fields. Defaults to all fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for the site:

* blog_id
* url
* last_updated
* registered

These fields are optionally available:

* site_id
* domain
* path
* public
* archived
* mature
* spam
* deleted
* lang_id

**EXAMPLES**

    # Get site by ID
    $ wp site get 1
    +---------+-------------------------+---------------------+---------------------+
    | blog_id | url                     | last_updated        | registered          |
    +---------+-------------------------+---------------------+---------------------+
    | 1       | http://example.com/     | 2025-01-01 12:00:00 | 2025-01-01 12:00:00 |
    +---------+-------------------------+---------------------+---------------------+

    # Get site URL by site ID
    $ wp site get 1 --field=url
    http://example.com/

    # Get site ID by URL
    $ wp site get http://example.com/subdir/ --field=blog_id
    2

    # Delete a site by URL
    $ wp site delete $(wp site get http://example.com/subdir/ --field=blog_id) --yes
    Success: The site at 'http://example.com/subdir/' was deleted.



### wp site list

Lists all sites in a multisite installation.

~~~
wp site list [--network=<id>|site_id|network_id] [--<field>=<value>] [--site__in=<value>] [--site__not_in=<value>] [--site_user=<value>] [--site-path=<path>] [--path__in=<value>] [--path__not_in=<value>] [--blog_id=<blog_id>|ID] [--network__in=<value>] [--network__not_in=<value>] [--domain=<domain>] [--domain__in=<value>] [--domain__not_in=<value>] [--registered=<date>] [--last_updated=<date>] [--public=<public>] [--archived=<archived>] [--mature=<mature>] [--spam=<spam>] [--deleted=<deleted>] [--lang_id=<lang_id>] [--lang__in=<value>] [--lang__not_in=<value>] [--search=<string>] [--search_columns=<columns>] [--meta_key=<meta_key>] [--meta_value=<meta_value>] [--meta_compare=<meta_compare>] [--meta_type=<meta_type>] [--meta_query=<meta_query>] [--date_query=<date_query>] [--number=<number>] [--offset=<offset>] [--no_found_rows=<no_found_rows>] [--update_site_cache=<update_site_cache>] [--update_site_meta_cache=<update_site_meta_cache>] [--orderby=<field>] [--order=<order>] [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	[--network=<id>|site_id|network_id]
		The network to which the sites belong. `--site_id` is the name of the
		column this filters, `--network_id` is WP_Site_Query's name for it, and
		both are accepted as aliases. `--network` wins when more than one is given.

	[--<field>=<value>]
		Filter by one or more fields (see "Available Fields" section), or pass any
		other argument accepted by WP_Site_Query. However, 'url' isn't an available
		filter, as it comes from 'home' in wp_options.
		Note: '--path' conflicts with the global parameter of the same name; use
		'--site-path' to filter by path instead.

	[--site__in=<value>]
		Only list the sites with these blog_id values (comma-separated).

	[--site__not_in=<value>]
		Exclude the sites with these blog_id values (comma-separated).

	[--site_user=<value>]
		Only list the sites with this user.

	[--site-path=<path>]
		Filter by path. Avoids conflict with the global `--path` parameter.

	[--path__in=<value>]
		Only list the sites with these paths (comma-separated).

	[--path__not_in=<value>]
		Exclude the sites with these paths (comma-separated).

	[--blog_id=<blog_id>|ID]
		Filter by site ID. `--ID` is WP_Site_Query's name for the same filter
		and is accepted as an alias.

	[--network__in=<value>]
		Only list the sites belonging to these network IDs (comma-separated).

	[--network__not_in=<value>]
		Exclude the sites belonging to these network IDs (comma-separated).

	[--domain=<domain>]
		Filter by domain.

	[--domain__in=<value>]
		Only list the sites with these domains (comma-separated).

	[--domain__not_in=<value>]
		Exclude the sites with these domains (comma-separated).

	[--registered=<date>]
		Filter by the date the site was registered. Accepts a timestamp or a
		date; a value carrying no time of day matches that whole day.

	[--last_updated=<date>]
		Filter by the date the site was last updated. Accepts a timestamp or a
		date; a value carrying no time of day matches that whole day.

	[--public=<public>]
		Filter by whether the site is public. Accepts 1 or 0.

	[--archived=<archived>]
		Filter by whether the site is archived. Accepts 1 or 0.

	[--mature=<mature>]
		Filter by whether the site is flagged as mature. Accepts 1 or 0.

	[--spam=<spam>]
		Filter by whether the site is flagged as spam. Accepts 1 or 0.

	[--deleted=<deleted>]
		Filter by whether the site is flagged as deleted. Accepts 1 or 0.

	[--lang_id=<lang_id>]
		Filter by language ID.

	[--lang__in=<value>]
		Only list the sites with these language IDs (comma-separated).

	[--lang__not_in=<value>]
		Exclude the sites with these language IDs (comma-separated).

	[--search=<string>]
		Only list the sites matching this search term. Searches the domain and
		path columns unless `--search_columns` narrows it.

	[--search_columns=<columns>]
		Comma-separated list of columns `--search` looks in. Accepts 'domain'
		and 'path'.

	[--meta_key=<meta_key>]
		Filter by this site meta key. The site meta arguments need WordPress 5.1
		or later, which is where multisite gained the table they read.

	[--meta_value=<meta_value>]
		Filter by this site meta value. Used together with `--meta_key`.

	[--meta_compare=<meta_compare>]
		Operator to test the meta value against. Accepts the operators
		WP_Meta_Query supports, such as '=', '!=', 'LIKE' or 'IN'.

	[--meta_type=<meta_type>]
		Cast the meta value to this type, such as 'NUMERIC' or 'DATE'.

	[--meta_query=<meta_query>]
		A WP_Meta_Query clause list, as JSON, for conditions the meta_* arguments
		above cannot express.

	[--date_query=<date_query>]
		A WP_Date_Query clause list, as JSON, for ranges `--registered` and
		`--last_updated` cannot express. Giving those as well narrows this further
		rather than replacing it.

	[--number=<number>]
		Limit the number of sites returned.

	[--offset=<offset>]
		Number of sites to skip. Used together with `--number`.

	[--no_found_rows=<no_found_rows>]
		Whether to skip counting the total rows the query matches. Accepts 1 or 0.

	[--update_site_cache=<update_site_cache>]
		Whether to prime the object cache with the sites found. Accepts 1 or 0.
		Turning it off saves work when listing a large network once.

	[--update_site_meta_cache=<update_site_meta_cache>]
		Whether to prime the object cache with the site meta of the sites found.
		Accepts 1 or 0.

	[--orderby=<field>]
		Order the results by this field, such as 'blog_id', 'domain', 'path',
		'registered', 'last_updated' or 'site__in'.

	[--order=<order>]
		Whether to order the results ascending or descending.
		---
		options:
		  - asc
		  - desc
		---

	[--field=<field>]
		Prints the value of a single field for each site.

	[--fields=<fields>]
		Comma-separated list of fields to show.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - count
		  - ids
		  - json
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each site:

* blog_id
* url
* last_updated
* registered

These fields are optionally available:

* site_id
* domain
* path
* public
* archived
* mature
* spam
* deleted
* lang_id

**EXAMPLES**

    # Output a simple list of site URLs
    $ wp site list --field=url
    http://www.example.com/
    http://www.example.com/subdir/

    # Output site URLs, most recently registered first
    $ wp site list --orderby=registered --order=desc --field=url
    http://www.example.com/subdir/
    http://www.example.com/

    # Search for sites by domain or path
    $ wp site list --search=subdir --field=url
    http://www.example.com/subdir/



### wp site mature

Sets one or more sites as mature.

~~~
wp site mature [<id>...] [--slug=<slug>]
~~~

**OPTIONS**

	[<id>...]
		One or more IDs of sites to set as mature. If not provided, you must set the --slug parameter.

	[--slug=<slug>]
		Path of the site to be set as mature. Subdomain on subdomain installs, directory on subdirectory installs.

**EXAMPLES**

    $ wp site mature 123
    Success: Site 123 marked as mature.

    $ wp site mature --slug=demo
    Success: Site 123 marked as mature.



### wp site meta

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

~~~
wp site meta
~~~

**EXAMPLES**

    # Set site meta
    $ wp site meta set 123 bio "Mary is a WordPress developer."
    Success: Updated custom field 'bio'.

    # Get site meta
    $ wp site meta get 123 bio
    Mary is a WordPress developer.

    # Update site meta
    $ wp site meta update 123 bio "Mary is an awesome WordPress developer."
    Success: Updated custom field 'bio'.

    # Delete site meta
    $ wp site meta delete 123 bio
    Success: Deleted custom field.





### wp site meta add

Add a meta field.

~~~
wp site meta add <id> <key> [<value>] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to create.

	[<value>]
		The value of the meta field. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp site meta delete

Delete a meta field.

~~~
wp site meta delete <id> [<key>] [<value>] [--all]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	[<key>]
		The name of the meta field to delete.

	[<value>]
		The value to delete. If omitted, all rows with key will deleted.

	[--all]
		Delete all meta for the object.



### wp site meta get

Get meta field value.

~~~
wp site meta get <id> <key> [--single] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to get.

	[--single]
		Whether to return a single value.

	[--format=<format>]
		Get value in a particular format.
		---
		default: var_export
		options:
		  - var_export
		  - json
		  - yaml
		---



### wp site meta list

List all metadata associated with an object.

~~~
wp site meta list <id> [--keys=<keys>] [--fields=<fields>] [--format=<format>] [--orderby=<fields>] [--order=<order>] [--unserialize]
~~~

**OPTIONS**

	<id>
		ID for the object.

	[--keys=<keys>]
		Limit output to metadata of specific keys.

	[--fields=<fields>]
		Limit the output to specific row fields. Defaults to id,meta_key,meta_value.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		  - count
		---

	[--orderby=<fields>]
		Set orderby which field.
		---
		default: id
		options:
		 - id
		 - meta_key
		 - meta_value
		---

	[--order=<order>]
		Set ascending or descending order.
		---
		default: asc
		options:
		 - asc
		 - desc
		---

	[--unserialize]
		Unserialize meta_value output.



### wp site meta patch

Update a nested value for a meta field.

~~~
wp site meta patch <action> <id> <key> <key-path>... [<value>] [--format=<format>]
~~~

**OPTIONS**

	<action>
		Patch action to perform.
		---
		options:
		  - insert
		  - update
		  - delete
		---

	<id>
		The ID of the object.

	<key>
		The name of the meta field to update.

	<key-path>...
		The name(s) of the keys within the value to locate the value to patch.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp site meta pluck

Get a nested value from a meta field.

~~~
wp site meta pluck <id> <key> <key-path>... [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to get.

	<key-path>...
		The name(s) of the keys within the value to locate the value to pluck.

	[--format=<format>]
		The output format of the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		  - yaml



### wp site meta update

Update a meta field.

~~~
wp site meta update <id> <key> [<value>] [--format=<format>]
~~~

**Alias:** `set`

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to update.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp site option

Adds, updates, deletes, and lists site options in a multisite installation.

~~~
wp site option
~~~

**EXAMPLES**

    # Get site registration
    $ wp site option get registration
    none

    # Add site option
    $ wp site option add my_option foobar
    Success: Added 'my_option' site option.

    # Update site option
    $ wp site option update my_option '{"foo": "bar"}' --format=json
    Success: Updated 'my_option' site option.

    # Delete site option
    $ wp site option delete my_option
    Success: Deleted 'my_option' site option.





### wp site option add

Adds a site option.

~~~
wp site option add <key> [<value>] [--format=<format>]
~~~

**OPTIONS**

	<key>
		The name of the site option to add.

	[<value>]
		The value of the site option to add. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---

**EXAMPLES**

    # Create a site option by reading a JSON file
    $ wp site option add my_option --format=json < config.json
    Success: Added 'my_option' site option.



### wp site option delete

Deletes a site option.

~~~
wp site option delete <key>
~~~

**OPTIONS**

	<key>
		Key for the site option.

**EXAMPLES**

    $ wp site option delete my_option
    Success: Deleted 'my_option' site option.



### wp site option get

Gets a site option.

~~~
wp site option get <key> [--format=<format>]
~~~

**OPTIONS**

	<key>
		Key for the site option.

	[--format=<format>]
		Get value in a particular format.
		---
		default: var_export
		options:
		  - var_export
		  - json
		  - yaml
		---

**EXAMPLES**

    # Get site upload filetypes
    $ wp site option get upload_filetypes
    jpg jpeg png gif mov avi mpg



### wp site option list

Lists site options.

~~~
wp site option list [--search=<pattern>] [--site_id=<id>] [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	[--search=<pattern>]
		Use wildcards ( * and ? ) to match option name.

	[--site_id=<id>]
		Limit options to those of a particular site id.

	[--field=<field>]
		Prints the value of a single field.

	[--fields=<fields>]
		Limit the output to specific object fields.

	[--format=<format>]
		The serialization format for the value. total_bytes displays the total size of matching options in bytes.
		---
		default: table
		options:
		  - table
		  - json
		  - csv
		  - count
		  - yaml
		  - total_bytes
		---

**AVAILABLE FIELDS**

This field will be displayed by default for each matching option:

* meta_key
* meta_value

These fields are optionally available:

* meta_id
* site_id
* size_bytes

**EXAMPLES**

    # List all site options beginning with "i2f_"
    $ wp site option list --search="i2f_*"
    +-------------+--------------+
    | meta_key    | meta_value   |
    +-------------+--------------+
    | i2f_version | 0.1.0        |
    +-------------+--------------+



### wp site option patch

Updates a nested value in an option.

~~~
wp site option patch <action> <key> <key-path>... [<value>] [--format=<format>]
~~~

**OPTIONS**

	<action>
		Patch action to perform.
		---
		options:
		  - insert
		  - update
		  - delete
		---

	<key>
		The option name.

	<key-path>...
		The name(s) of the keys within the value to locate the value to patch.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp site option pluck

Gets a nested value from an option.

~~~
wp site option pluck <key> <key-path>... [--format=<format>]
~~~

**OPTIONS**

	<key>
		The option name.

	<key-path>...
		The name(s) of the keys within the value to locate the value to pluck.

	[--format=<format>]
		The output format of the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		  - yaml



### wp site option update

Updates a site option.

~~~
wp site option update <key> [<value>] [--format=<format>]
~~~

**Alias:** `set`

**OPTIONS**

	<key>
		The name of the site option to update.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---

**EXAMPLES**

    # Update a site option by reading from a file
    $ wp site option update my_option < value.txt
    Success: Updated 'my_option' site option.



### wp site private

Sets one or more sites as private.

~~~
wp site private [<id>...] [--slug=<slug>]
~~~

**OPTIONS**

	[<id>...]
		One or more IDs of sites to set as private. If not provided, you must set the --slug parameter.

	[--slug=<slug>]
		Path of the site to be set as private. Subdomain on subdomain installs, directory on subdirectory installs.

**EXAMPLES**

    $ wp site private 123
    Success: Site 123 marked as private.

    $ wp site private --slug=demo
    Success: Site 123 marked as private.



### wp site public

Sets one or more sites as public.

~~~
wp site public [<id>...] [--slug=<slug>]
~~~

**OPTIONS**

	[<id>...]
		One or more IDs of sites to set as public. If not provided, you must set the --slug parameter.

	[--slug=<slug>]
		Path of the site to be set as public. Subdomain on subdomain installs, directory on subdirectory installs.

**EXAMPLES**

    $ wp site public 123
    Success: Site 123 marked as public.

     $ wp site public --slug=demo
     Success: Site 123 marked as public.



### wp site spam

Marks one or more sites as spam.

~~~
wp site spam [<id>...] [--slug=<slug>]
~~~

**OPTIONS**

	[<id>...]
		One or more IDs of sites to be marked as spam. If not provided, you must set the --slug parameter.

	[--slug=<slug>]
		Path of the site to be marked as spam. Subdomain on subdomain installs, directory on subdirectory installs.

**EXAMPLES**

    $ wp site spam 123
    Success: Site 123 marked as spam.



### wp site unarchive

Unarchives one or more sites.

~~~
wp site unarchive [<id>...] [--slug=<slug>]
~~~

**OPTIONS**

	[<id>...]
		One or more IDs of sites to unarchive. If not provided, you must set the --slug parameter.

	[--slug=<slug>]
		Path of the site to unarchive. Subdomain on subdomain installs, directory on subdirectory installs.

**EXAMPLES**

    $ wp site unarchive 123
    Success: Site 123 unarchived.

    $ wp site unarchive --slug=demo
    Success: Site 123 unarchived.



### wp site unmature

Sets one or more sites as immature.

~~~
wp site unmature [<id>...] [--slug=<slug>]
~~~

**OPTIONS**

	[<id>...]
		One or more IDs of sites to set as unmature. If not provided, you must set the --slug parameter.

	[--slug=<slug>]
		Path of the site to be set as unmature. Subdomain on subdomain installs, directory on subdirectory installs.

**EXAMPLES**

    $ wp site unmature 123
    Success: Site 123 marked as unmature.

    $ wp site unmature --slug=demo
    Success: Site 123 marked as unmature.



### wp site unspam

Removes one or more sites from spam.

~~~
wp site unspam [<id>...] [--slug=<slug>]
~~~

**OPTIONS**

	[<id>...]
		One or more IDs of sites to remove from spam. If not provided, you must set the --slug parameter.

	[--slug=<slug>]
		Path of the site to be removed from spam. Subdomain on subdomain installs, directory on subdirectory installs.

**EXAMPLES**

    $ wp site unspam 123
    Success: Site 123 removed from spam.



### wp taxonomy

Retrieves information about registered taxonomies.

~~~
wp taxonomy
~~~

See references for [built-in taxonomies](https://developer.wordpress.org/themes/basics/categories-tags-custom-taxonomies/) and [custom taxonomies](https://developer.wordpress.org/plugins/taxonomies/working-with-custom-taxonomies/).

**EXAMPLES**

    # List all taxonomies with 'post' object type.
    $ wp taxonomy list --object_type=post --fields=name,public
    +-------------+--------+
    | name        | public |
    +-------------+--------+
    | category    | 1      |
    | post_tag    | 1      |
    | post_format | 1      |
    +-------------+--------+

    # Get capabilities of 'post_tag' taxonomy.
    $ wp taxonomy get post_tag --field=cap
    {"manage_terms":"manage_categories","edit_terms":"manage_categories","delete_terms":"manage_categories","assign_terms":"edit_posts"}



### wp taxonomy get

Gets details about a registered taxonomy.

~~~
wp taxonomy get <taxonomy> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<taxonomy>
		Taxonomy slug.

	[--field=<field>]
		Instead of returning the whole taxonomy, returns the value of a single field.

	[--fields=<fields>]
		Limit the output to specific fields. Defaults to all fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for the specified taxonomy:

* name
* label
* description
* object_type
* show_tagcloud
* hierarchical
* public
* labels
* cap

These fields are optionally available:

* count

**EXAMPLES**

    # Get details of `category` taxonomy.
    $ wp taxonomy get category --fields=name,label,object_type
    +-------------+------------+
    | Field       | Value      |
    +-------------+------------+
    | name        | category   |
    | label       | Categories |
    | object_type | ["post"]   |
    +-------------+------------+

    # Get capabilities of 'post_tag' taxonomy.
    $ wp taxonomy get post_tag --field=cap
    {"manage_terms":"manage_categories","edit_terms":"manage_categories","delete_terms":"manage_categories","assign_terms":"edit_posts"}



### wp taxonomy list

Lists registered taxonomies.

~~~
wp taxonomy list [--<field>=<value>] [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	[--<field>=<value>]
		Filter by one or more fields (see get_taxonomies() first parameter for a list of available fields).

	[--field=<field>]
		Prints the value of a single field for each taxonomy.

	[--fields=<fields>]
		Limit the output to specific taxonomy fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each term:

* name
* label
* description
* object_type
* show_tagcloud
* hierarchical
* public

These fields are optionally available:

* count

**EXAMPLES**

    # List all taxonomies.
    $ wp taxonomy list --format=csv
    name,label,description,object_type,show_tagcloud,hierarchical,public
    category,Categories,,post,1,1,1
    post_tag,Tags,,post,1,,1
    nav_menu,"Navigation Menus",,nav_menu_item,,,
    link_category,"Link Categories",,link,1,,
    post_format,Format,,post,,,1

    # List all taxonomies with 'post' object type.
    $ wp taxonomy list --object_type=post --fields=name,public
    +-------------+--------+
    | name        | public |
    +-------------+--------+
    | category    | 1      |
    | post_tag    | 1      |
    | post_format | 1      |
    +-------------+--------+



### wp term

Manages taxonomy terms and term meta, with create, delete, and list commands.

~~~
wp term
~~~

See reference for [taxonomies and their terms](https://wordpress.org/documentation/article/taxonomies).

**EXAMPLES**

    # Create a new term.
    $ wp term create category Apple --description="A type of fruit"
    Success: Created category 199.

    # Get details about a term.
    $ wp term get category 199 --format=json --fields=term_id,name,slug,count
    {"term_id":199,"name":"Apple","slug":"apple","count":1}

    # Update an existing term.
    $ wp term update category 15 --name=Apple
    Success: Term updated.

    # Get the term's URL.
    $ wp term list post_tag --include=123 --field=url
    http://example.com/tag/tips-and-tricks

    # Delete post category
    $ wp term delete category 15
    Success: Deleted category 15.

    # Recount posts assigned to each categories and tags
    $ wp term recount category post_tag
    Success: Updated category term count
    Success: Updated post_tag term count

    # Prune terms with 0 or 1 published posts
    $ wp term prune post_tag
    Deleted post_tag 15.
    Success: Pruned 1 of 5 terms.



### wp term create

Creates a new term.

~~~
wp term create <taxonomy> <term> [--slug=<slug>] [--description=<description>] [--parent=<term-id>] [--porcelain]
~~~

**OPTIONS**

	<taxonomy>
		Taxonomy for the new term.

	<term>
		A name for the new term.

	[--slug=<slug>]
		A unique slug for the new term. Defaults to sanitized version of name.

	[--description=<description>]
		A description for the new term.

	[--parent=<term-id>]
		A parent for the new term.

	[--porcelain]
		Output just the new term id.

**EXAMPLES**

    # Create a new category "Apple" with a description.
    $ wp term create category Apple --description="A type of fruit"
    Success: Created category 199.



### wp term delete

Deletes an existing term.

~~~
wp term delete <taxonomy> <term>... [--by=<field>]
~~~

Errors if the term doesn't exist, or there was a problem in deleting it.

**OPTIONS**

	<taxonomy>
		Taxonomy of the term to delete.

	<term>...
		One or more IDs or slugs of terms to delete.

	[--by=<field>]
		Explicitly handle the term value as a slug or id.
		---
		default: id
		options:
		  - slug
		  - id
		---

**EXAMPLES**

    # Delete post category by id
    $ wp term delete category 15
    Deleted category 15.
    Success: Deleted 1 of 1 terms.

    # Delete post category by slug
    $ wp term delete category apple --by=slug
    Deleted category 15.
    Success: Deleted 1 of 1 terms.

    # Delete all post tags
    $ wp term list post_tag --field=term_id | xargs wp term delete post_tag
    Deleted post_tag 159.
    Deleted post_tag 160.
    Deleted post_tag 161.
    Success: Deleted 3 of 3 terms.



### wp term generate

Generates some terms.

~~~
wp term generate <taxonomy> [--count=<number>] [--max_depth=<number>] [--format=<format>]
~~~

Creates a specified number of new terms with dummy data.

**OPTIONS**

	<taxonomy>
		The taxonomy for the generated terms.

	[--count=<number>]
		How many terms to generate?
		---
		default: 100
		---

	[--max_depth=<number>]
		Generate child terms down to a certain depth.
		---
		default: 1
		---

	[--format=<format>]
		Render output in a particular format.
		---
		default: progress
		options:
		  - progress
		  - ids
		---

**EXAMPLES**

    # Generate post categories.
    $ wp term generate category --count=10
    Generating terms  100% [=========] 0:02 / 0:02

    # Add meta to every generated term.
    $ wp term generate category --format=ids --count=3 | xargs -d ' ' -I % wp term meta add % foo bar
    Success: Added custom field.
    Success: Added custom field.
    Success: Added custom field.



### wp term get

Gets details about a term.

~~~
wp term get <taxonomy> <term> [--by=<field>] [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<taxonomy>
		Taxonomy of the term to get

	<term>
		ID or slug of the term to get

	[--by=<field>]
		Explicitly handle the term value as a slug or id.
		---
		default: id
		options:
		  - slug
		  - id
		---

	[--field=<field>]
		Instead of returning the whole term, returns the value of a single field.

	[--fields=<fields>]
		Limit the output to specific fields. Defaults to all fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**EXAMPLES**

    # Get details about a category with id 199.
    $ wp term get category 199 --format=json
    {"term_id":199,"name":"Apple","slug":"apple","term_group":0,"term_taxonomy_id":199,"taxonomy":"category","description":"A type of fruit","parent":0,"count":0,"filter":"raw"}

    # Get details about a category with slug apple.
    $ wp term get category apple --by=slug --format=json
    {"term_id":199,"name":"Apple","slug":"apple","term_group":0,"term_taxonomy_id":199,"taxonomy":"category","description":"A type of fruit","parent":0,"count":0,"filter":"raw"}



### wp term list

Lists terms in a taxonomy.

~~~
wp term list <taxonomy>... [--<field>=<value>] [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<taxonomy>...
		List terms of one or more taxonomies

	[--<field>=<value>]
		Filter by one or more fields (see get_terms() $args parameter for a list of fields).

	[--field=<field>]
		Prints the value of a single field for each term.

	[--fields=<fields>]
		Limit the output to specific object fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - ids
		  - json
		  - count
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each term:

* term_id
* term_taxonomy_id
* name
* slug
* description
* parent
* count

These fields are optionally available:

* term_group
* url

**EXAMPLES**

    # List post categories
    $ wp term list category --format=csv
    term_id,term_taxonomy_id,name,slug,description,parent,count
    2,2,aciform,aciform,,0,1
    3,3,antiquarianism,antiquarianism,,0,1
    4,4,arrangement,arrangement,,0,1
    5,5,asmodeus,asmodeus,,0,1

    # List post tags
    $ wp term list post_tag --fields=name,slug
    +-----------+-------------+
    | name      | slug        |
    +-----------+-------------+
    | 8BIT      | 8bit        |
    | alignment | alignment-2 |
    | Articles  | articles    |
    | aside     | aside       |
    +-----------+-------------+



### wp term meta

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

~~~
wp term meta
~~~

**EXAMPLES**

    # Set term meta
    $ wp term meta set 123 bio "Mary is a WordPress developer."
    Success: Updated custom field 'bio'.

    # Get term meta
    $ wp term meta get 123 bio
    Mary is a WordPress developer.

    # Update term meta
    $ wp term meta update 123 bio "Mary is an awesome WordPress developer."
    Success: Updated custom field 'bio'.

    # Delete term meta
    $ wp term meta delete 123 bio
    Success: Deleted custom field.





### wp term meta add

Add a meta field.

~~~
wp term meta add <id> <key> [<value>] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to create.

	[<value>]
		The value of the meta field. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp term meta delete

Delete a meta field.

~~~
wp term meta delete <id> [<key>] [<value>] [--all]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	[<key>]
		The name of the meta field to delete.

	[<value>]
		The value to delete. If omitted, all rows with key will deleted.

	[--all]
		Delete all meta for the object.



### wp term meta get

Get meta field value.

~~~
wp term meta get <id> <key> [--single] [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to get.

	[--single]
		Whether to return a single value.

	[--format=<format>]
		Get value in a particular format.
		---
		default: var_export
		options:
		  - var_export
		  - json
		  - yaml
		---



### wp term meta list

List all metadata associated with an object.

~~~
wp term meta list <id> [--keys=<keys>] [--fields=<fields>] [--format=<format>] [--orderby=<fields>] [--order=<order>] [--unserialize]
~~~

**OPTIONS**

	<id>
		ID for the object.

	[--keys=<keys>]
		Limit output to metadata of specific keys.

	[--fields=<fields>]
		Limit the output to specific row fields. Defaults to id,meta_key,meta_value.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		  - count
		---

	[--orderby=<fields>]
		Set orderby which field.
		---
		default: id
		options:
		 - id
		 - meta_key
		 - meta_value
		---

	[--order=<order>]
		Set ascending or descending order.
		---
		default: asc
		options:
		 - asc
		 - desc
		---

	[--unserialize]
		Unserialize meta_value output.



### wp term meta patch

Update a nested value for a meta field.

~~~
wp term meta patch <action> <id> <key> <key-path>... [<value>] [--format=<format>]
~~~

**OPTIONS**

	<action>
		Patch action to perform.
		---
		options:
		  - insert
		  - update
		  - delete
		---

	<id>
		The ID of the object.

	<key>
		The name of the meta field to update.

	<key-path>...
		The name(s) of the keys within the value to locate the value to patch.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp term meta pluck

Get a nested value from a meta field.

~~~
wp term meta pluck <id> <key> <key-path>... [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to get.

	<key-path>...
		The name(s) of the keys within the value to locate the value to pluck.

	[--format=<format>]
		The output format of the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		  - yaml



### wp term meta update

Update a meta field.

~~~
wp term meta update <id> <key> [<value>] [--format=<format>]
~~~

**Alias:** `set`

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to update.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp term migrate

Migrate a term of a taxonomy to another taxonomy.

~~~
wp term migrate <term> [--by=<field>] [--from=<taxonomy>] [--to=<taxonomy>]
~~~

**OPTIONS**

	<term>
		Slug or ID of the term to migrate.

	[--by=<field>]
		Explicitly handle the term value as a slug or id.
		---
		default: id
		options:
		  - slug
		  - id
		---

	[--from=<taxonomy>]
		Taxonomy slug of the term to migrate.

	[--to=<taxonomy>]
		Taxonomy slug to migrate to.

**EXAMPLES**

    # Migrate a category's term (video) to tag taxonomy.
    $ wp term migrate 9190 --from=category --to=post_tag
    Term 'video' assigned to post 1155.
    Term 'video' migrated.
    Old instance of term 'video' removed from its original taxonomy.
    Success: Migrated the term 'video' from taxonomy 'category' to taxonomy 'post_tag' for 1 post.



### wp term recount

Recalculates number of posts assigned to each term.

~~~
wp term recount <taxonomy>...
~~~

In instances where manual updates are made to the terms assigned to
posts in the database, the number of posts associated with a term
can become out-of-sync with the actual number of posts.

This command runs wp_update_term_count() on the taxonomy's terms
to bring the count back to the correct value.

**OPTIONS**

	<taxonomy>...
		One or more taxonomies to recalculate.

**EXAMPLES**

    # Recount posts assigned to each categories and tags
    $ wp term recount category post_tag
    Success: Updated category term count.
    Success: Updated post_tag term count.

    # Recount all listed taxonomies
    $ wp taxonomy list --field=name | xargs wp term recount
    Success: Updated category term count.
    Success: Updated post_tag term count.
    Success: Updated nav_menu term count.
    Success: Updated link_category term count.
    Success: Updated post_format term count.



### wp term prune

Removes terms with 0 or 1 published posts from one or more taxonomies.

~~~
wp term prune <taxonomy>... [--dry-run]
~~~

Useful for cleaning up large sites with many unused or barely-used terms.
The term count is based on the number of published posts assigned to each
term.

**OPTIONS**

	<taxonomy>...
		One or more taxonomies to prune.

	[--dry-run]
		Preview the terms to be pruned, without actually deleting them.

**EXAMPLES**

    # Prune post tags with 0 or 1 published posts.
    $ wp term prune post_tag
    Deleted post_tag 15.
    Success: Pruned 1 of 5 terms.

    # Dry run to preview which terms would be pruned.
    $ wp term prune post_tag --dry-run
    Would delete post_tag 15.
    Success: 1 post_tag term would be pruned.

    # Prune multiple taxonomies at once.
    $ wp term prune category post_tag
    Deleted category 8.
    Success: Pruned 1 of 3 terms.
    Deleted post_tag 15.
    Success: Pruned 1 of 5 terms.



### wp term update

Updates an existing term.

~~~
wp term update <taxonomy> <term> [--by=<field>] [--name=<name>] [--slug=<slug>] [--description=<description>] [--parent=<term-id>]
~~~

**OPTIONS**

	<taxonomy>
		Taxonomy of the term to update.

	<term>
		ID or slug for the term to update.

	[--by=<field>]
		Explicitly handle the term value as a slug or id.
		---
		default: id
		options:
		  - slug
		  - id
		---

	[--name=<name>]
		A new name for the term.

	[--slug=<slug>]
		A new slug for the term.

	[--description=<description>]
		A new description for the term.

	[--parent=<term-id>]
		A new parent for the term.

**EXAMPLES**

    # Change category with id 15 to use the name "Apple"
    $ wp term update category 15 --name=Apple
    Success: Term updated.

    # Change category with slug apple to use the name "Apple"
    $ wp term update category apple --by=slug --name=Apple
    Success: Term updated.



### wp user

Manages users, along with their roles, capabilities, and meta.

~~~
wp user
~~~

See references for [Roles and Capabilities](https://wordpress.org/documentation/article/roles-and-capabilities)
and [WP User class](https://developer.wordpress.org/reference/classes/wp_user).

**EXAMPLES**

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

    # Create a new user.
    $ wp user create bob bob@example.com --role=author
    Success: Created user 3.
    Password: k9**&I4vNH(&

    # Update an existing user.
    $ wp user update 123 --display_name=Mary --user_pass=marypass
    Success: Updated user 123.

    # Delete user 123 and reassign posts to user 567
    $ wp user delete 123 --reassign=567
    Success: Removed user 123 from http://example.com.



### wp user add-cap

Adds a capability to a user.

~~~
wp user add-cap <user> <cap>
~~~

**OPTIONS**

	<user>
		User ID, user email, or user login.

	<cap>
		The capability to add.

**EXAMPLES**

    # Add a capability for a user
    $ wp user add-cap john create_premium_item
    Success: Added 'create_premium_item' capability for john (16).

    # Add a capability for a user
    $ wp user add-cap 15 edit_product
    Success: Added 'edit_product' capability for johndoe (15).



### wp user add-role

Adds a role for a user.

~~~
wp user add-role <user> [<role>...]
~~~

**OPTIONS**

	<user>
		User ID, user email, or user login.

	[<role>...]
		Add the specified role(s) to the user.

**EXAMPLES**

    $ wp user add-role 12 author
    Success: Added 'author' role for johndoe (12).

    $ wp user add-role 12 author editor
    Success: Added 'author', 'editor' roles for johndoe (12).



### wp user application-password

Creates, updates, deletes, lists and retrieves application passwords.

~~~
wp user application-password
~~~

**EXAMPLES**

    # List user application passwords and only show app name and password hash
    $ wp user application-password list 123 --fields=name,password
    +--------+------------------------------------+
    | name   | password                           |
    +--------+------------------------------------+
    | myapp  | $P$BVGeou1CUot114YohIemgpwxQCzb8O/ |
    +--------+------------------------------------+

    # Get a specific application password and only show app name and created timestamp
    $ wp user application-password get 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --fields=name,created
    +--------+------------+
    | name   | created    |
    +--------+------------+
    | myapp  | 1638395611 |
    +--------+------------+

    # Create user application password
    $ wp user application-password create 123 myapp
    Success: Created application password.
    Password: ZG1bxdxdzjTwhsY8vK8l1C65

    # Only print the password without any chrome
    $ wp user application-password create 123 myapp --porcelain
    ZG1bxdxdzjTwhsY8vK8l1C65

    # Update an existing application password
    $ wp user application-password update 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --name=newappname
    Success: Updated application password.

    # Delete an existing application password
    $ wp user application-password delete 123 6633824d-c1d7-4f79-9dd5-4586f734d69e
    Success: Deleted 1 of 1 application password.

    # Check if an application password for a given application exists
    $ wp user application-password exists 123 myapp
    $ echo $?
    1

    # Bash script for checking whether an application password exists and creating one if not
    if ! wp user application-password exists 123 myapp; then
        PASSWORD=$(wp user application-password create 123 myapp --porcelain)
    fi





### wp user application-password create

Creates a new application password.

~~~
wp user application-password create <user> <app-name> [--app-id=<app-id>] [--porcelain]
~~~

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to create a new application password for.

	<app-name>
		Unique name of the application to create an application password for.

	[--app-id=<app-id>]
		Application ID to attribute to the application password.

	[--porcelain]
		Output just the new password.

**EXAMPLES**

    # Create user application password
    $ wp user application-password create 123 myapp
    Success: Created application password.
    Password: ZG1bxdxdzjTwhsY8vK8l1C65

    # Only print the password without any chrome
    $ wp user application-password create 123 myapp --porcelain
    ZG1bxdxdzjTwhsY8vK8l1C65

    # Create user application with a custom application ID for internal tracking
    $ wp user application-password create 123 myapp --app-id=42 --porcelain
    ZG1bxdxdzjTwhsY8vK8l1C65



### wp user application-password delete

Delete an existing application password.

~~~
wp user application-password delete <user> [<uuid>...] [--all]
~~~

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to delete the application password for.

	[<uuid>...]
		Comma-separated list of UUIDs of the application passwords to delete.

	[--all]
		Delete all of the user's application password.

**EXAMPLES**

    # Delete an existing application password
    $ wp user application-password delete 123 6633824d-c1d7-4f79-9dd5-4586f734d69e
    Success: Deleted 1 of 1 application password.

    # Delete all of the user's application passwords
    $ wp user application-password delete 123 --all
    Success: Deleted all application passwords.



### wp user application-password exists

Checks whether an application password for a given application exists.

~~~
wp user application-password exists <user> <app-name>
~~~

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to check the existence of an application password for.

	<app-name>
		Name of the application to check the existence of an application password for.

**EXAMPLES**

    # Check if an application password for a given application exists
    $ wp user application-password exists 123 myapp
    $ echo $?
    1

    # Bash script for checking whether an application password exists and creating one if not
    if ! wp user application-password exists 123 myapp; then
        PASSWORD=$(wp user application-password create 123 myapp --porcelain)
    fi



### wp user application-password get

Gets a specific application password.

~~~
wp user application-password get <user> <uuid> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to get the application password for.

	<uuid>
		The universally unique ID of the application password.

	[--field=<field>]
		Prints the value of a single field for the application password.

	[--fields=<fields>]
		Limit the output to specific fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**EXAMPLES**

    # Get a specific application password and only show app name and created timestamp
    $ wp user application-password get 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --fields=name,created
    +--------+------------+
    | name   | created    |
    +--------+------------+
    | myapp  | 1638395611 |
    +--------+------------+



### wp user application-password list

Lists all application passwords associated with a user.

~~~
wp user application-password list <user> [--<field>=<value>] [--uuid=<uuid>] [--app_id=<app_id>] [--name=<name>] [--password=<password>] [--created=<created>] [--last_used=<last_used>] [--last_ip=<last_ip>] [--field=<field>] [--fields=<fields>] [--format=<format>] [--orderby=<fields>] [--order=<order>]
~~~

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to get application passwords for.

	[--<field>=<value>]
		Filter the list by a specific field.

	[--uuid=<uuid>]
		Filter by the universally unique ID of the application password.

	[--app_id=<app_id>]
		Filter by the application ID. `--app-id` is also accepted.

	[--name=<name>]
		Filter by the name of the application password.

	[--password=<password>]
		Filter by the hashed password.

	[--created=<created>]
		Filter by the Unix timestamp the application password was created at.

	[--last_used=<last_used>]
		Filter by the Unix timestamp the application password was last used at.
		`--last-used` is also accepted.

	[--last_ip=<last_ip>]
		Filter by the IP address the application password was last used from.
		`--last-ip` is also accepted.

	[--field=<field>]
		Prints the value of a single field for each application password.

	[--fields=<fields>]
		Limit the output to specific fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - yaml
		  - ids
		---

	[--orderby=<fields>]
		Set orderby which field.
		---
		default: created
		options:
		 - uuid
		 - app_id
		 - name
		 - password
		 - created
		 - last_used
		 - last_ip
		---

	[--order=<order>]
		Set ascending or descending order.
		---
		default: desc
		options:
		 - asc
		 - desc
		---

**EXAMPLES**

    # List user application passwords and only show app name and password hash
    $ wp user application-password list 123 --fields=name,password
    +--------+------------------------------------+
    | name   | password                           |
    +--------+------------------------------------+
    | myapp  | $P$BVGeou1CUot114YohIemgpwxQCzb8O/ |
    +--------+------------------------------------+



### wp user application-password record-usage

Record usage of an application password.

~~~
wp user application-password record-usage <user> <uuid>
~~~

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to update the application password for.

	<uuid>
		The universally unique ID of the application password.

**EXAMPLES**

    # Record usage of an application password
    $ wp user application-password record-usage 123 6633824d-c1d7-4f79-9dd5-4586f734d69e
    Success: Recorded application password usage.



### wp user application-password update

Updates an existing application password.

~~~
wp user application-password update <user> <uuid> [--name=<name>]
~~~

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to update the application password for.

	<uuid>
		The universally unique ID of the application password.

	[--name=<name>]
		The new name of the application password.

**EXAMPLES**

    # Update an existing application password
    $ wp user application-password update 123 6633824d-c1d7-4f79-9dd5-4586f734d69e --name=newappname
    Success: Updated application password.



### wp user check-password

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

~~~
wp user check-password <user> <user_pass> [--escape-chars]
~~~

**OPTIONS**

	<user>
		The user login, user email or user ID of the user to check credentials for.

	<user_pass>
		A string that contains the plain text password for the user.

	[--escape-chars]
		Escape password with `wp_slash()` to mimic the same behavior as `wp-login.php`.

**EXAMPLES**

    # Check whether given credentials are valid; exit status 0 if valid, otherwise 1
    $ wp user check-password admin adminpass
    $ echo $?
    1

    # Bash script for checking whether given credentials are valid or not
    if ! $(wp user check-password admin adminpass); then
     notify-send "Invalid Credentials";
    fi



### wp user create

Creates a new user.

~~~
wp user create <user-login> <user-email> [--role=<role>] [--user_pass=<password>] [--user_registered=<yyyy-mm-dd-hh-ii-ss>] [--display_name=<name>] [--user_nicename=<nice_name>] [--user_url=<url>] [--nickname=<nickname>] [--first_name=<first_name>] [--last_name=<last_name>] [--description=<description>] [--rich_editing=<rich_editing>] [--send-email] [--porcelain]
~~~

**OPTIONS**

	<user-login>
		The login of the user to create.

	<user-email>
		The email address of the user to create.

	[--role=<role>]
		The role of the user to create. Default: default role. Possible values
		include 'administrator', 'editor', 'author', 'contributor', 'subscriber'.

	[--user_pass=<password>]
		The user password. Default: randomly generated.

	[--user_registered=<yyyy-mm-dd-hh-ii-ss>]
		The date the user registered. Default: current date.

	[--display_name=<name>]
		The display name.

	[--user_nicename=<nice_name>]
		A string that contains a URL-friendly name for the user. The default is the user's username.

	[--user_url=<url>]
		A string containing the user's URL for the user's web site.

	[--nickname=<nickname>]
		The user's nickname, defaults to the user's username.

	[--first_name=<first_name>]
		The user's first name.

	[--last_name=<last_name>]
		The user's last name.

	[--description=<description>]
		A string containing content about the user.

	[--rich_editing=<rich_editing>]
		A string for whether to enable the rich editor or not. False if not empty.

	[--send-email]
		Send an email to the user with their new account details.

	[--porcelain]
		Output just the new user id.

**EXAMPLES**

    # Create user
    $ wp user create bob bob@example.com --role=author
    Success: Created user 3.
    Password: k9**&I4vNH(&

    # Create user without showing password upon success
    $ wp user create ann ann@example.com --porcelain
    4



### wp user delete

Deletes one or more users from the current site.

~~~
wp user delete <user>... [--network] [--reassign=<user-id>] [--yes]
~~~

On multisite, `wp user delete` only removes the user from the current
site. Include `--network` to also remove the user from the database, but
make sure to reassign their posts prior to deleting the user.

**OPTIONS**

	<user>...
		The user login, user email, or user ID of the user(s) to delete.

	[--network]
		On multisite, delete the user from the entire network.

	[--reassign=<user-id>]
		User ID to reassign the posts to.

	[--yes]
		Answer yes to any confirmation prompts.

**EXAMPLES**

    # Delete user 123 and reassign posts to user 567
    $ wp user delete 123 --reassign=567
    Success: Removed user 123 from http://example.com.

    # Delete all contributors and reassign their posts to user 2
    $ wp user delete $(wp user list --role=contributor --field=ID) --reassign=2
    Success: Removed user 813 from http://example.com.
    Success: Removed user 578 from http://example.com.

    # Delete all contributors in batches of 100 (avoid error: argument list too long: wp)
    $ wp user delete $(wp user list --role=contributor --field=ID | head -n 100)



### wp user exists

Verifies whether a user exists.

~~~
wp user exists <id>
~~~

Displays a success message if the user does exist.

**OPTIONS**

	<id>
		The ID of the user to check.

**EXAMPLES**

    # The user exists.
    $ wp user exists 1337
    Success: User with ID 1337 exists.
    $ echo $?
    0

    # The user does not exist.
    $ wp user exists 10000
    $ echo $?
    1



### wp user generate

Generates some users.

~~~
wp user generate [--count=<number>] [--role=<role>] [--format=<format>]
~~~

Creates a specified number of new users with dummy data.

**OPTIONS**

	[--count=<number>]
		How many users to generate?
		---
		default: 100
		---

	[--role=<role>]
		The role of the generated users. Default: default role from WP

	[--format=<format>]
		Render output in a particular format.
		---
		default: progress
		options:
		  - progress
		  - ids
		---

**EXAMPLES**

    # Add meta to every generated users.
    $ wp user generate --format=ids --count=3 | xargs -d ' ' -I % wp user meta add % foo bar
    Success: Added custom field.
    Success: Added custom field.
    Success: Added custom field.



### wp user get

Gets details about a user.

~~~
wp user get <user> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<user>
		User ID, user email, or user login.

	[--field=<field>]
		Instead of returning the whole user, returns the value of a single field.

	[--fields=<fields>]
		Get a specific subset of the user's fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**EXAMPLES**

    # Get user
    $ wp user get 12 --field=login
    supervisor

    # Get user and export to JSON file
    $ wp user get bob --format=json > bob.json



### wp user import-csv

Imports users from a CSV file.

~~~
wp user import-csv <file> [--send-email] [--skip-update]
~~~

If the user already exists (matching the email address or login), then
the user is updated unless the `--skip-update` flag is used.

**OPTIONS**

	<file>
		The local or remote CSV file of users to import. If '-', then reads from STDIN.

	[--send-email]
		Send an email to new users with their account details.

	[--skip-update]
		Don't update users that already exist.

**EXAMPLES**

    # Import users from local CSV file
    $ wp user import-csv /path/to/users.csv
    Success: bobjones created.
    Success: newuser1 created.
    Success: existinguser created.

    # Import users from remote CSV file
    $ wp user import-csv http://example.com/users.csv

    Sample users.csv file:

    user_login,user_email,display_name,role
    bobjones,bobjones@example.com,Bob Jones,contributor
    newuser1,newuser1@example.com,New User,author
    existinguser,existinguser@example.com,Existing User,administrator



### 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()](https://developer.wordpress.org/reference/classes/wp_user_query/prepare_query/).

**OPTIONS**

	[--role=<role>]
		Only display users with a certain role.

	[--<field>=<value>]
		Control output by one or more arguments of WP_User_Query().

	[--network]
		List all users in the network for multisite. Roles are not included when using this flag, as users can have different roles on different sites in a multisite network.

	[--field=<field>]
		Prints the value of a single field for each user.

	[--fields=<fields>]
		Limit the output to specific object fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - ids
		  - json
		  - count
		  - yaml
		---

**AVAILABLE FIELDS**

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
* url

**EXAMPLES**

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

    # List users with administrator role
    $ wp user list --role=administrator --format=csv
    ID,user_login,display_name,user_email,user_registered,roles
    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
    [{"display_name":"supervisor","user_email":"supervisor@gmail.com"}]

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



### wp user list-caps

Lists all capabilities for a user.

~~~
wp user list-caps <user> [--format=<format>] [--origin=<origin>] [--exclude-role-names]
~~~

**OPTIONS**

	<user>
		User ID, user email, or login.

	[--format=<format>]
		Render output in a particular format.
		---
		default: list
		options:
		  - list
		  - table
		  - csv
		  - json
		  - count
		  - yaml
		---

	[--origin=<origin>]
		Render output in a particular format.
		---
		default: all
		options:
		  - all
		  - user
		  - role
		---

	[--exclude-role-names]
		Exclude capabilities that match role names from output.

**EXAMPLES**

    $ wp user list-caps 21
    edit_product
    create_premium_item



### wp user meta

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

~~~
wp user meta
~~~

**EXAMPLES**

    # Add user meta
    $ wp user meta add 123 bio "Mary is an WordPress developer."
    Success: Added custom field.

    # List user meta
    $ wp user meta list 123 --keys=nickname,description,wp_capabilities
    +---------+-----------------+--------------------------------+
    | user_id | meta_key        | meta_value                     |
    +---------+-----------------+--------------------------------+
    | 123     | nickname        | supervisor                     |
    | 123     | description     | Mary is a WordPress developer. |
    | 123     | wp_capabilities | {"administrator":true}         |
    +---------+-----------------+--------------------------------+

    # Update user meta
    $ wp user meta update 123 bio "Mary is an awesome WordPress developer."
    Success: Updated custom field 'bio'.

    # Delete user meta
    $ wp user meta delete 123 bio
    Success: Deleted custom field.





### wp user meta add

Adds a meta field.

~~~
wp user meta add <user> <key> <value> [--format=<format>]
~~~

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to add metadata for.

	<key>
		The metadata key.

	<value>
		The new metadata value.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---

**EXAMPLES**

    # Add user meta
    $ wp user meta add 123 bio "Mary is an WordPress developer."
    Success: Added custom field.



### wp user meta delete

Deletes a meta field.

~~~
wp user meta delete <user> <key> [<value>]
~~~

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to delete metadata from.

	<key>
		The metadata key.

	[<value>]
		The value to delete. If omitted, all rows with key will deleted.

**EXAMPLES**

    # Delete user meta
    $ wp user meta delete 123 bio
    Success: Deleted custom field.



### wp user meta get

Gets meta field value.

~~~
wp user meta get <user> <key> [--format=<format>]
~~~

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to get metadata for.

	<key>
		The metadata key.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**EXAMPLES**

    # Get user meta
    $ wp user meta get 123 bio
    Mary is an WordPress developer.

    # Get the primary site of a user (for multisite)
    $ wp user meta get 2 primary_blog
    3



### wp user meta list

Lists all metadata associated with a user.

~~~
wp user meta list <user> [--keys=<keys>] [--fields=<fields>] [--format=<format>] [--orderby=<fields>] [--order=<order>] [--unserialize]
~~~

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to get metadata for.

	[--keys=<keys>]
		Limit output to metadata of specific keys.

	[--fields=<fields>]
		Limit the output to specific row fields. Defaults to id,meta_key,meta_value.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - count
		  - yaml
		---

	[--orderby=<fields>]
		Set orderby which field.
		---
		default: id
		options:
		 - id
		 - meta_key
		 - meta_value
		---

	[--order=<order>]
		Set ascending or descending order.
		---
		default: asc
		options:
		 - asc
		 - desc
		---

	[--unserialize]
		Unserialize meta_value output.

**EXAMPLES**

    # List user meta
    $ wp user meta list 123 --keys=nickname,description,wp_capabilities
    +---------+-----------------+--------------------------------+
    | user_id | meta_key        | meta_value                     |
    +---------+-----------------+--------------------------------+
    | 123     | nickname        | supervisor                     |
    | 123     | description     | Mary is a WordPress developer. |
    | 123     | wp_capabilities | {"administrator":true}         |
    +---------+-----------------+--------------------------------+



### wp user meta patch

Update a nested value for a meta field.

~~~
wp user meta patch <action> <id> <key> <key-path>... [<value>] [--format=<format>]
~~~

**OPTIONS**

	<action>
		Patch action to perform.
		---
		options:
		  - insert
		  - update
		  - delete
		---

	<id>
		The ID of the object.

	<key>
		The name of the meta field to update.

	<key-path>...
		The name(s) of the keys within the value to locate the value to patch.

	[<value>]
		The new value. If omitted, the value is read from STDIN.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---



### wp user meta pluck

Get a nested value from a meta field.

~~~
wp user meta pluck <id> <key> <key-path>... [--format=<format>]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<key>
		The name of the meta field to get.

	<key-path>...
		The name(s) of the keys within the value to locate the value to pluck.

	[--format=<format>]
		The output format of the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		  - yaml



### wp user meta update

Updates a meta field.

~~~
wp user meta update <user> <key> <value> [--format=<format>]
~~~

**Alias:** `set`

**OPTIONS**

	<user>
		The user login, user email, or user ID of the user to update metadata for.

	<key>
		The metadata key.

	<value>
		The new metadata value.

	[--format=<format>]
		The serialization format for the value.
		---
		default: plaintext
		options:
		  - plaintext
		  - json
		---

**EXAMPLES**

    # Update user meta
    $ wp user meta update 123 bio "Mary is an awesome WordPress developer."
    Success: Updated custom field 'bio'.



### wp user privacy-request

Manages user privacy requests (GDPR personal data export and erasure).

~~~
wp user privacy-request
~~~

**EXAMPLES**

    # List all privacy requests.
    $ wp user privacy-request list
    +----+-------------------+----------------------+-------------------+--------------------+
    | ID | user_email        | action_name          | status            | created_timestamp  |
    +----+-------------------+----------------------+-------------------+--------------------+
    | 1  | bob@example.com   | export_personal_data | request-pending   | 1713779524         |
    +----+-------------------+----------------------+-------------------+--------------------+

    # Create a new data export request.
    $ wp user privacy-request create bob@example.com export_personal_data
    Success: Created privacy request 1.

    # Erase personal data for request 1.
    $ wp user privacy-request erase 1
    Success: Erased personal data for request 1.

    # Export personal data for request 1.
    $ wp user privacy-request export 1
    Success: Exported personal data to: /var/www/html/wp-content/uploads/wp-personal-data-exports/wp-personal-data-export-bob-example-com-1.zip

    # Mark request 1 as complete.
    $ wp user privacy-request complete 1
    Success: Completed 1 of 1 privacy requests.

    # Delete request 1.
    $ wp user privacy-request delete 1
    Success: Deleted 1 of 1 privacy requests.





### wp user privacy-request complete

Marks one or more privacy requests as completed.

~~~
wp user privacy-request complete <request-id>...
~~~

**OPTIONS**

	<request-id>...
		One or more IDs of the privacy requests to complete.

**EXAMPLES**

    # Mark request 1 as completed.
    $ wp user privacy-request complete 1
    Privacy request 1 completed.
    Success: Completed 1 of 1 privacy requests.

    # Mark multiple requests as completed.
    $ wp user privacy-request complete 1 2
    Privacy request 1 completed.
    Privacy request 2 completed.
    Success: Completed 2 of 2 privacy requests.



### wp user privacy-request create

Creates a privacy request for a user.

~~~
wp user privacy-request create <email> <action-type> [--status=<status>] [--send-email] [--porcelain]
~~~

**OPTIONS**

	<email>
		The email address of the user to create the request for.

	<action-type>
		The type of personal data request.
		---
		options:
		  - export_personal_data
		  - remove_personal_data
		---

	[--status=<status>]
		The initial status of the request.
		---
		default: pending
		options:
		  - pending
		  - confirmed
		---

	[--send-email]
		If set, sends a confirmation email to the user.

	[--porcelain]
		Output just the new request ID.

**EXAMPLES**

    # Create a new data export request with pending status.
    $ wp user privacy-request create bob@example.com export_personal_data
    Success: Created privacy request 1.

    # Create a confirmed data erasure request.
    $ wp user privacy-request create bob@example.com remove_personal_data --status=confirmed
    Success: Created privacy request 2.

    # Get just the new request ID.
    $ wp user privacy-request create bob@example.com export_personal_data --porcelain
    3



### wp user privacy-request delete

Deletes one or more privacy requests.

~~~
wp user privacy-request delete <request-id>...
~~~

**OPTIONS**

	<request-id>...
		One or more IDs of the privacy requests to delete.

**EXAMPLES**

    # Delete privacy request 1.
    $ wp user privacy-request delete 1
    Privacy request 1 deleted.
    Success: Deleted 1 of 1 privacy requests.

    # Delete multiple privacy requests.
    $ wp user privacy-request delete 1 2 3
    Privacy request 1 deleted.
    Privacy request 2 deleted.
    Privacy request 3 deleted.
    Success: Deleted 3 of 3 privacy requests.



### wp user privacy-request erase

Erases personal data for a given privacy request.

~~~
wp user privacy-request erase <request-id>
~~~

Runs all registered data erasers for the email address associated with the
request, then marks the request as completed.

**OPTIONS**

	<request-id>
		The ID of the remove_personal_data privacy request to process.

**EXAMPLES**

    # Erase personal data for request 1.
    $ wp user privacy-request erase 1
    Success: Erased personal data for request 1.



### wp user privacy-request export

Exports personal data for a given privacy request.

~~~
wp user privacy-request export <request-id>
~~~

Runs all registered data exporters for the email address associated with
the request, generates a ZIP file containing the data, then marks the
request as completed.

**OPTIONS**

	<request-id>
		The ID of the export_personal_data privacy request to process.

**EXAMPLES**

    # Export personal data for request 1.
    $ wp user privacy-request export 1
    Success: Exported personal data to: /var/www/html/wp-content/uploads/wp-personal-data-exports/wp-personal-data-export-bob-example-com-1.zip



### wp user privacy-request list

Lists privacy requests.

~~~
wp user privacy-request list [--action-type=<action-type>] [--status=<status>] [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	[--action-type=<action-type>]
		Filter the list by action type.
		---
		options:
		  - export_personal_data
		  - remove_personal_data
		---

	[--status=<status>]
		Filter the list by request status.
		---
		options:
		  - request-pending
		  - request-confirmed
		  - request-failed
		  - request-completed
		---

	[--field=<field>]
		Prints the value of a single field for each request.

	[--fields=<fields>]
		Limit the output to specific object fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - ids
		  - json
		  - count
		  - yaml
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each request:

* ID
* user_email
* action_name
* status
* created_timestamp

These fields are optionally available:

* user_id
* confirmed_timestamp
* completed_timestamp

**EXAMPLES**

    # List all privacy requests.
    $ wp user privacy-request list
    +----+-------------------+----------------------+-------------------+--------------------+
    | ID | user_email        | action_name          | status            | created_timestamp  |
    +----+-------------------+----------------------+-------------------+--------------------+
    | 1  | bob@example.com   | export_personal_data | request-pending   | 1713779524         |
    +----+-------------------+----------------------+-------------------+--------------------+

    # List only export requests.
    $ wp user privacy-request list --action-type=export_personal_data

    # List only completed requests.
    $ wp user privacy-request list --status=request-completed

    # List request IDs only.
    $ wp user privacy-request list --format=ids
    1 2



### wp user remove-cap

Removes a user's capability.

~~~
wp user remove-cap <user> <cap> [--force]
~~~

**OPTIONS**

	<user>
		User ID, user email, or user login.

	<cap>
		The capability to be removed.

	[--force]
		Forcefully remove a capability.

**EXAMPLES**

    $ wp user remove-cap 11 publish_newsletters
    Success: Removed 'publish_newsletters' cap for supervisor (11).

    $ wp user remove-cap 11 publish_posts
    Error: The 'publish_posts' cap for supervisor (11) is inherited from a role.

    $ wp user remove-cap 11 nonexistent_cap
    Error: No such 'nonexistent_cap' cap for supervisor (11).

    $ wp user remove-cap 11 publish_newsletters --force
    Success: Removed 'publish_newsletters' cap for supervisor (11).



### wp user remove-role

Removes a user's role.

~~~
wp user remove-role <user> [<role>...]
~~~

**OPTIONS**

	<user>
		User ID, user email, or user login.

	[<role>...]
		Remove the specified role(s) from the user. If not passed, all roles are
		removed from the user; on multisite, this removes the user from the current
		site/blog.

**EXAMPLES**

    $ wp user remove-role 12 author
    Success: Removed 'author' role from johndoe (12).

    $ wp user remove-role 12 author editor
    Success: Removed 'author', 'editor' roles from johndoe (12).

    # On single-site: removes all roles from the user
    $ wp user remove-role 12
    Success: Removed all roles from johndoe (12) on http://example.com.

    # On multisite: removes the user from the current site/blog
    $ wp user remove-role 12
    Success: Removed johndoe (12) from http://example.com.



### wp user reset-password

Resets the password for one or more users.

~~~
wp user reset-password <user>... [--skip-email] [--show-password] [--porcelain]
~~~

**OPTIONS**

	<user>...
		one or more user logins or IDs.

	[--skip-email]
		Don't send an email notification to the affected user(s).

	[--show-password]
		Show the new password(s).

	[--porcelain]
		Output only the new password(s).

**EXAMPLES**

    # Reset the password for two users and send them the change email.
    $ wp user reset-password admin editor
    Reset password for admin.
    Reset password for editor.
    Success: Passwords reset for 2 users.

    # Reset and display the password.
    $ wp user reset-password editor --show-password
    Reset password for editor.
    Password: N6hAau0fXZMN#rLCIirdEGOh
    Success: Password reset for 1 user.

    # Reset the password for one user, displaying only the new password, and not sending the change email.
    $ wp user reset-password admin --skip-email --porcelain
    yV6BP*!d70wg

    # Reset password for all users.
    $ wp user reset-password $(wp user list --format=ids)
    Reset password for admin.
    Reset password for editor.
    Reset password for subscriber.
    Success: Passwords reset for 3 users.

    # Reset password for all users with a particular role.
    $ wp user reset-password $(wp user list --format=ids --role=administrator)
    Reset password for admin.
    Success: Password reset for 1 user.



### wp user session

Destroys and lists a user's sessions.

~~~
wp user session
~~~

**EXAMPLES**

    # List a user's sessions.
    $ wp user session list admin@example.com --format=csv
    login_time,expiration_time,ip,ua
    "2016-01-01 12:34:56","2016-02-01 12:34:56",127.0.0.1,"Mozilla/5.0..."

    # Destroy the most recent session of the given user.
    $ wp user session destroy admin
    Success: Destroyed session. 3 sessions remaining.





### wp user session destroy

Destroy a session for the given user.

~~~
wp user session destroy <user> [<token>] [--all]
~~~

**OPTIONS**

	<user>
		User ID, user email, or user login.

	[<token>]
		The token of the session to destroy. Defaults to the most recently created session.

	[--all]
		Destroy all of the user's sessions.

**EXAMPLES**

    # Destroy the most recent session of the given user.
    $ wp user session destroy admin
    Success: Destroyed session. 3 sessions remaining.

    # Destroy a specific session of the given user.
    $ wp user session destroy admin e073ad8540a9c2...
    Success: Destroyed session. 2 sessions remaining.

    # Destroy all the sessions of the given user.
    $ wp user session destroy admin --all
    Success: Destroyed all sessions.

    # Destroy all sessions for all users.
    $ wp user list --field=ID | xargs -n 1 wp user session destroy --all
    Success: Destroyed all sessions.
    Success: Destroyed all sessions.



### wp user session list

List sessions for the given user.

~~~
wp user session list <user> [--fields=<fields>] [--format=<format>]
~~~

Note: The `token` field does not return the actual token, but a hash of
it. The real token is not persisted and can only be found in the
corresponding cookies on the client side.

**OPTIONS**

	<user>
		User ID, user email, or user login.

	[--fields=<fields>]
		Limit the output to specific fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		  - count
		  - ids
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each session:

* token
* login_time
* expiration_time
* ip
* ua

These fields are optionally available:

* expiration
* login

**EXAMPLES**

    # List a user's sessions.
    $ wp user session list admin@example.com --format=csv
    login_time,expiration_time,ip,ua
    "2016-01-01 12:34:56","2016-02-01 12:34:56",127.0.0.1,"Mozilla/5.0..."



### wp user set-role

Sets the user role.

~~~
wp user set-role <user> [<role>]
~~~

**OPTIONS**

	<user>
		User ID, user email, or user login.

	[<role>]
		Make the user have the specified role. If not passed, the default role is
		used.

**EXAMPLES**

    $ wp user set-role 12 author
    Success: Added johndoe (12) to http://example.com as author.



### wp user signup

Manages signups on a multisite installation.

~~~
wp user signup
~~~

**EXAMPLES**

    # List signups.
    $ wp user signup list
    +-----------+------------+---------------------+---------------------+--------+------------------+
    | signup_id | user_login | user_email          | registered          | active | activation_key   |
    +-----------+------------+---------------------+---------------------+--------+------------------+
    | 1         | bobuser    | bobuser@example.com | 2024-03-13 05:46:53 | 1      | 7320b2f009266618 |
    | 2         | johndoe    | johndoe@example.com | 2024-03-13 06:24:44 | 0      | 9068d859186cd0b5 |
    +-----------+------------+---------------------+---------------------+--------+------------------+

    # Activate signup.
    $ wp user signup activate 2
    Signup 2 activated. Password: bZFSGsfzb9xs
    Success: Activated 1 of 1 signups.

    # Delete signup.
    $ wp user signup delete 3
    Signup 3 deleted.
    Success: Deleted 1 of 1 signups.





### wp user signup activate

Activates one or more signups.

~~~
wp user signup activate <signup>...
~~~

**OPTIONS**

	<signup>...
		The signup ID, user login, user email, or activation key of the signup(s) to activate.

**EXAMPLES**

    # Activate signup.
    $ wp user signup activate 2
    Signup 2 activated. Password: bZFSGsfzb9xs
    Success: Activated 1 of 1 signups.



### wp user signup delete

Deletes one or more signups.

~~~
wp user signup delete [<signup>...] [--all]
~~~

**OPTIONS**

	[<signup>...]
		The signup ID, user login, user email, or activation key of the signup(s) to delete.

	[--all]
		If set, all signups will be deleted.

**EXAMPLES**

    # Delete signup.
    $ wp user signup delete 3
    Signup 3 deleted.
    Success: Deleted 1 of 1 signups.



### wp user signup get

Gets details about a signup.

~~~
wp user signup get <signup> [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<signup>
		The signup ID, user login, user email, or activation key.

	[--field=<field>]
		Instead of returning the whole signup, returns the value of a single field.

	[--fields=<fields>]
		Limit the output to specific fields. Defaults to all fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		---

**EXAMPLES**

    # Get signup.
    $ wp user signup get 1 --field=user_login
    bobuser

    # Get signup and export to JSON file.
    $ wp user signup get bobuser --format=json > bobuser.json



### wp user signup list

Lists signups.

~~~
wp user signup list [--<field>=<value>] [--field=<field>] [--fields=<fields>] [--format=<format>] [--per_page=<per_page>]
~~~

**OPTIONS**

	[--<field>=<value>]
		Filter the list by a specific field.

	[--field=<field>]
		Prints the value of a single field for each signup.

	[--fields=<fields>]
		Limit the output to specific object fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - ids
		  - json
		  - count
		  - yaml
		---

	[--per_page=<per_page>]
		Limits the signups to the given number. Defaults to none.

**AVAILABLE FIELDS**

These fields will be displayed by default for each signup:

* signup_id
* user_login
* user_email
* registered
* active
* activation_key

These fields are optionally available:

* domain
* path
* title
* activated
* meta
* add_to_blog
* new_role
* blog_id

**EXAMPLES**

    # List signup IDs.
    $ wp user signup list --field=signup_id
    1

    # List all signups.
    $ wp user signup list
    +-----------+------------+---------------------+---------------------+--------+------------------+
    | signup_id | user_login | user_email          | registered          | active | activation_key   |
    +-----------+------------+---------------------+---------------------+--------+------------------+
    | 1         | bobuser    | bobuser@example.com | 2024-03-13 05:46:53 | 1      | 7320b2f009266618 |
    | 2         | johndoe    | johndoe@example.com | 2024-03-13 06:24:44 | 0      | 9068d859186cd0b5 |
    +-----------+------------+---------------------+---------------------+--------+------------------+



### wp user spam

Marks one or more users as spam on multisite.

~~~
wp user spam <user>...
~~~

**OPTIONS**

	<user>...
		The user login, user email, or user ID of the user(s) to mark as spam.

**EXAMPLES**

    # Mark user as spam.
    $ wp user spam 123
    User 123 marked as spam.
    Success: Spammed 1 of 1 users.



### wp user term

Adds, updates, removes, and lists user terms.

~~~
wp user term
~~~

**EXAMPLES**

    # Set user terms
    $ wp user term set 123 test category
    Success: Set terms.





### wp user term add

Add a term to an object.

~~~
wp user term add <id> <taxonomy> <term>... [--by=<field>]
~~~

Append the term to the existing set of terms on the object.

**OPTIONS**

	<id>
		The ID of the object.

	<taxonomy>
		The name of the taxonomy type to be added.

	<term>...
		The slug of the term or terms to be added.

	[--by=<field>]
		Explicitly handle the term value as a slug or id.
		---
		default: slug
		options:
		  - slug
		  - id
		---



### wp user term list

List all terms associated with an object.

~~~
wp user term list <id> <taxonomy>... [--field=<field>] [--fields=<fields>] [--format=<format>]
~~~

**OPTIONS**

	<id>
		ID for the object.

	<taxonomy>...
		One or more taxonomies to list.

	[--field=<field>]
		Prints the value of a single field for each term.

	[--fields=<fields>]
		Limit the output to specific row fields.

	[--format=<format>]
		Render output in a particular format.
		---
		default: table
		options:
		  - table
		  - csv
		  - json
		  - yaml
		  - count
		  - ids
		---

**AVAILABLE FIELDS**

These fields will be displayed by default for each term:

* term_id
* name
* slug
* taxonomy

These fields are optionally available:

* term_taxonomy_id
* description
* term_group
* parent
* count



### wp user term remove

Remove a term from an object.

~~~
wp user term remove <id> <taxonomy> [<term>...] [--by=<field>] [--all]
~~~

**OPTIONS**

	<id>
		The ID of the object.

	<taxonomy>
		The name of the term's taxonomy.

	[<term>...]
		The slug of the term or terms to be removed from the object.

	[--by=<field>]
		Explicitly handle the term value as a slug or id.
		---
		default: slug
		options:
		  - slug
		  - id
		---

	[--all]
		Remove all terms from the object.



### wp user term set

Set object terms.

~~~
wp user term set <id> <taxonomy> <term>... [--by=<field>]
~~~

Replaces existing terms on the object.

**OPTIONS**

	<id>
		The ID of the object.

	<taxonomy>
		The name of the taxonomy type to be updated.

	<term>...
		The slug of the term or terms to be updated.

	[--by=<field>]
		Explicitly handle the term value as a slug or id.
		---
		default: slug
		options:
		  - slug
		  - id
		---



### wp user unspam

Removes one or more users from spam on multisite.

~~~
wp user unspam <user>...
~~~

**OPTIONS**

	<user>...
		The user login, user email, or user ID of the user(s) to remove from spam.

**EXAMPLES**

    # Remove user from spam.
    $ wp user unspam 123
    User 123 removed from spam.
    Success: Unspamed 1 of 1 users.



### wp user update

Updates an existing user.

~~~
wp user update <user>... [--user_pass=<password>] [--user_nicename=<nice_name>] [--user_url=<url>] [--user_email=<email>] [--display_name=<display_name>] [--nickname=<nickname>] [--first_name=<first_name>] [--last_name=<last_name>] [--description=<description>] [--rich_editing=<rich_editing>] [--syntax_highlighting=<syntax_highlighting>] [--comment_shortcuts=<comment_shortcuts>] [--admin_color=<admin_color>] [--use_ssl=<use_ssl>] [--user_registered=<yyyy-mm-dd-hh-ii-ss>] [--user_activation_key=<user_activation_key>] [--spam=<spam>] [--show_admin_bar_front=<show_admin_bar_front>] [--role=<role>] [--locale=<locale>] [--meta_input=<meta_input>] --<field>=<value> [--skip-email]
~~~

**OPTIONS**

	<user>...
		The user login, user email or user ID of the user(s) to update.

	[--user_pass=<password>]
		A string that contains the plain text password for the user.

	[--user_nicename=<nice_name>]
		A string that contains a URL-friendly name for the user. The default is the user's username.

	[--user_url=<url>]
		A string containing the user's URL for the user's web site.

	[--user_email=<email>]
		A string containing the user's email address.

	[--display_name=<display_name>]
		A string that will be shown on the site. Defaults to user's username.

	[--nickname=<nickname>]
		The user's nickname, defaults to the user's username.

	[--first_name=<first_name>]
		The user's first name.

	[--last_name=<last_name>]
		The user's last name.

	[--description=<description>]
		A string containing content about the user.

	[--rich_editing=<rich_editing>]
		A string for whether to enable the rich editor or not. False if not empty.

	[--syntax_highlighting=<syntax_highlighting>]
		Whether to enable the rich code editor for the user. Accepts 'true' or
		'false' as a string literal, not boolean.

	[--comment_shortcuts=<comment_shortcuts>]
		Whether to enable comment moderation keyboard shortcuts for the user.
		Accepts 'true' or 'false' as a string literal, not boolean.

	[--admin_color=<admin_color>]
		Admin color scheme for the user.

	[--use_ssl=<use_ssl>]
		Whether the user should always access the admin over https.

	[--user_registered=<yyyy-mm-dd-hh-ii-ss>]
		The date the user registered.

	[--user_activation_key=<user_activation_key>]
		Password reset key.

	[--spam=<spam>]
		Multisite only. Whether the user is marked as spam.

	[--show_admin_bar_front=<show_admin_bar_front>]
		Whether to display the admin bar for the user on the site's front end.
		Accepts 'true' or 'false' as a string literal, not boolean.

	[--role=<role>]
		A string used to set the user's role.

	[--locale=<locale>]
		The user's locale.

	[--meta_input=<meta_input>]
		Array in JSON format of user meta values keyed by their user meta key.

	--<field>=<value>
		One or more fields to update. For accepted fields, see wp_update_user().

	[--skip-email]
		Don't send an email notification to the user.

**EXAMPLES**

    # Update user
    $ wp user update 123 --display_name=Mary --user_pass=marypass
    Success: Updated user 123.

## Installing

This package is included with WP-CLI itself, no additional installation necessary.

To install the latest version of this package over what's included in WP-CLI, run:

    wp package install git@github.com:wp-cli/entity-command.git

## Contributing

We appreciate you taking the initiative to contribute to this project.

Contributing isn’t limited to just code. We encourage you to contribute in the way that best fits your abilities, by writing tutorials, giving a demo at your local meetup, helping other users with their support questions, or revising our documentation.

For a more thorough introduction, [check out WP-CLI's guide to contributing](https://make.wordpress.org/cli/handbook/contributing/). This package follows those policy and guidelines.

### Reporting a bug

Think you’ve found a bug? We’d love for you to help us get it fixed.

Before you create a new issue, you should [search existing issues](https://github.com/wp-cli/entity-command/issues?q=label%3Abug%20) to see if there’s an existing resolution to it, or if it’s already been fixed in a newer version.

Once you’ve done a bit of searching and discovered there isn’t an open or fixed issue for your bug, please [create a new issue](https://github.com/wp-cli/entity-command/issues/new). Include as much detail as you can, and clear steps to reproduce if possible. For more guidance, [review our bug report documentation](https://make.wordpress.org/cli/handbook/bug-reports/).

### Creating a pull request

Want to contribute a new feature? Please first [open a new issue](https://github.com/wp-cli/entity-command/issues/new) to discuss whether the feature is a good fit for the project.

Once you've decided to commit the time to seeing your pull request through, [please follow our guidelines for creating a pull request](https://make.wordpress.org/cli/handbook/pull-requests/) to make sure it's a pleasant experience. See "[Setting up](https://make.wordpress.org/cli/handbook/pull-requests/#setting-up)" for details specific to working on this package locally.

### License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Support

GitHub issues aren't for general support questions. For support resources and next steps, see the WP-CLI Support page: https://make.wordpress.org/cli/handbook/support/


*This README.md is generated dynamically from the project's codebase using `wp scaffold package-readme` ([doc](https://github.com/wp-cli/scaffold-package-command#wp-scaffold-package-readme)). To suggest changes, please submit a pull request against the corresponding part of the codebase.*