Skip to main content
To edit an existing item in your 1Password account, use the op item edit command. You can edit basic information about the item with flags and use assignment statements to edit an item’s built-in and custom fields. To edit sensitive values, use a JSON template. You can’t use op item edit to edit SSH keys. Learn more about managing SSH keys with 1Password CLI.

​
Requirements

Before you can use 1Password CLI to edit items, you’ll need to:
Follow alongIf you want to follow along with the examples in this guide, create the example items in the guide to creating items first.

​
Edit an item’s basic information

To edit an item, use op item edit and specify the item by name, unique identifier (ID), or sharing link. You can use flags to generate a new password and edit an item’s title, vault, or tags. You can also change the website where 1Password suggests and fills a Login, Password, or API Credential item. For example, to change the name of the example item Netflix, move it from the Tutorial vault to the Private vault, update its tags, edit its website, and generate a new random password: 
op item edit "Netflix" \
    --title "Edited Netflix" \
    --vault Private \
    --tags tutorial \
    --url https://www.netflix.com \
    --generate-password='letters,digits,symbols,32'
To change the example item name back to Netflix and move it back to the Tutorial vault: 
op item edit "Edited Netflix" \
    --title "Netflix" \
    --vault Tutorial

​
Edit built-in and custom fields

Command arguments can be visible to other processes on your machine. To edit sensitive values, use an item JSON template instead.
The op item edit command can take a list of assignment statements as arguments to edit an item’s built-in and custom fields. 
[<section>.]<field>[[<fieldType>]]=<value>
  • section (Optional) The name of the section where the field is saved.
  • field The name of the field.
  • fieldType The type of field. If unspecified, the fieldType stays the same.
  • value The information you want to save in the field. If unspecified, the value stays the same.
For example, to change the subscription renewal date on the HBO Max item: 
op item edit "HBO Max" \
    'Renewal Date=2023-5-15'

​
Delete a custom field

To delete a custom field, specify [delete] in place of the fieldType. If you remove all the fields in a section, the section is also removed. You can’t delete empty fields, but you can set them to empty strings. To use an assignment statement to delete the subscription renewal date on the example HBO Max item: 
op item edit "HBO Max" \
    'Renewal Date[delete]=2023-5-15'

​
Edit an item using a JSON template

JSON item templates do not support passkeys. If you use a JSON template to update an item that contains a passkey, the passkey will be overwritten. To fix this, you can restore a previous version of the item.
To edit sensitive values on an item, use an item JSON template.
  1. Get the JSON output for the item you want to edit and save it to a file. 
    op item get <item> --format json > newItem.json
    If you prefer to start over, you can get a blank template for the item’s category with op item template get.
  2. Edit the file.
  3. Use the --template flag to specify the path to the edited file and apply the changes to the item: 
    op item edit <item> --template=newItem.json
  4. Delete the file.
You can also edit an item using piped input: 
	cat newItem.json | op item edit <item>
To avoid collisions, you can’t combine piped input and the --template flag in the same command.

​
Next steps

If you created a Tutorial vault, you can delete the vault and the examples items you created: 
op vault delete "Tutorial"

​
Learn more