Title: wp post meta
Published: February 5, 2018
Last modified: October 8, 2026

---

# 󠀁[wp post meta <command>](https://developer.wordpress.org/cli/commands/post/meta/)󠁿

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

## In this article

 * [Examples](https://developer.wordpress.org/cli/commands/post/meta/?output_format=md#examples)
 * [Subcommands](https://developer.wordpress.org/cli/commands/post/meta/?output_format=md#subcommands)

[ Back to top](https://developer.wordpress.org/cli/commands/post/meta/?output_format=md#wp--skip-link--target)

 [ ⌊GitHub⌉ ](https://github.com/wp-cli/entity-command)

 [ View Open Issues (0) ](https://github.com/login?return_to=%2Fissues%3Fq%3Dlabel%3Acommand%3Apost-meta+sort%3Aupdated-desc+org%3Awp-cli+is%3Aopen)
[ View Closed Issues (8) ](https://github.com/login?return_to=%2Fissues%3Fq%3Dlabel%3Acommand%3Apost-meta+sort%3Aupdated-desc+org%3Awp-cli+is%3Aclosed)
[Create New Issue](https://github.com/wp-cli/entity-command/issues/new)

### 󠀁[Examples](https://developer.wordpress.org/cli/commands/post/meta/?output_format=md#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.
    ```

### 󠀁[Subcommands](https://developer.wordpress.org/cli/commands/post/meta/?output_format=md#subcommands)󠁿

| Name | Description | 
| [wp post meta add](https://developer.wordpress.org/cli/commands/post/meta/add/) |

Add a meta field.

  | 
| [wp post meta clean-duplicates](https://developer.wordpress.org/cli/commands/post/meta/clean-duplicates/) |

Cleans up duplicate post meta values on a post.

  | 
| [wp post meta delete](https://developer.wordpress.org/cli/commands/post/meta/delete/) |

Delete a meta field.

  | 
| [wp post meta get](https://developer.wordpress.org/cli/commands/post/meta/get/) |

Get meta field value.

  | 
| [wp post meta list](https://developer.wordpress.org/cli/commands/post/meta/list/) |

List all metadata associated with an object.

  | 
| [wp post meta patch](https://developer.wordpress.org/cli/commands/post/meta/patch/) |

Update a nested value for a meta field.

  | 
| [wp post meta pluck](https://developer.wordpress.org/cli/commands/post/meta/pluck/) |

Get a nested value from a meta field.

  | 
| [wp post meta set](https://developer.wordpress.org/cli/commands/post/meta/set/) |

Update a meta field.

  | 
| [wp post meta update](https://developer.wordpress.org/cli/commands/post/meta/update/) |

Update a meta field.

  |

 _Command documentation is regenerated at every release. To add or update an example,
please submit a pull request against the corresponding part of the codebase._