Skip to main content
When you use 1Password CLI to create items, you can customize your items with built-in and custom fields. Learn how to add built-in and custom fields to your items with either assignment statements or a JSON template.

​
Built-in fields

Each item category includes a set of default fields, some of which may be specific to the category. You can identify available built-in fields by looking at the JSON template for the item category: 
op item template get <category>
  • API Credential
  • Bank Account
  • Credit Card
  • Crypto Wallet
  • Database
  • Document
  • Driver License
  • Email Account
  • Identity
  • Login
  • Medical Record
  • Membership
  • Outdoor License
  • Passport
  • Password
  • Reward Program
  • Secure Note
  • Server
  • Social Security Number
  • Software License
  • SSH Key
  • Wireless Router
For example, the built-in fields available on a Login item are username, password, and notesPlain. 
{
  "title": "",
  "category": "LOGIN",
  "fields": [
    {
      "id": "username",
      "type": "STRING",
      "purpose": "USERNAME",
      "label": "username",
      "value": ""
    },
    {
      "id": "password",
      "type": "CONCEALED",
      "purpose": "PASSWORD",
      "label": "password",
      "password_details": {
        "strength": "TERRIBLE"
      },
      "value": ""
    },
    {
      "id": "notesPlain",
      "type": "STRING",
      "purpose": "NOTES",
      "label": "notesPlain",
      "value": ""
    }
  ]
}
When you use assignment statements to assign built-in fields, use the id from the JSON template as the field in the assignment statement. Don’t include a fieldType for built-in fields. For example, to add a note to a Login item using an assignment statement: 
'notesPlain=This is a note.'

​
Custom fields

Custom fields can be added to any item, regardless of the item’s category. Use the fieldType with assignment statements and the type with an item JSON template. Available custom field types are:
fieldTypetypedescription
passwordCONCEALEDA concealed password.
textSTRINGA text string.
emailEMAILAn email address.
urlURLA web address to copy or open in your default web browser, not used for autofill behavior. Use the --url flag to set the website where 1Password suggests and fills a Login, Password, or API Credential item.
dateDATEA date with the format YYYY-MM-DD.
monthYearMONTH_YEARA date with the format YYYYMM or YYYY/MM.
phonePHONEA phone number.
otpOTPA one-time password. Accepts an otpauth:// URI as the value.
fileN/AA file attachment. Accepts the path to the file as the value. Can only be added with assignment statements.

​
Learn more