mirror of
https://github.com/bitwarden/help
synced 2025-12-13 06:43:18 +00:00
61 lines
2.9 KiB
Markdown
61 lines
2.9 KiB
Markdown
---
|
|
layout: article
|
|
title: Using custom fields
|
|
categories: [features]
|
|
featured: false
|
|
popular: false
|
|
tags: [fields, autofill, custom fields]
|
|
---
|
|
|
|
Custom fields allow you to store additional, well structured data fields within your vault entries. These fields could be security questions, PINs, or anything else. Custom fields have a name, a value, and a type (text, hidden, and boolean).
|
|
|
|
## Using Custom Fields to Auto-fill
|
|
|
|
Custom field names are an important identifier. Depending on the name you give your custom field, Bitwarden will attempt to auto-fill the custom field's value for you. If you intend to auto-fill custom fields you should name your field based on an identifier from the webpage form. These names are searched for using the following criteria:
|
|
|
|
- HTML form element's **id** attribute
|
|
- then the HTML form element's **name** attribute
|
|
- then the HTML form element's corresponding **label** value
|
|
- then the HTML form element's **aria-label** attribute
|
|
- then the HTML form element's **placeholder** attribute
|
|
|
|
If one of these matches is found, Bitwarden will auto-fill the custom field's value for you.
|
|
|
|
### Here is an example of how to configure a Custom Field using the id attribute:
|
|
|
|
1. Right-click the field you want to fill and select "Inspect". The HTML element will appear highlighted in the console window.
|
|
2. Find the element id. You are looking for what comes after id=" ". Copy what is in between the " ".
|
|
<img width="80%" src="../../images/features/custom-fields/custom_field.gif">
|
|
3. Open the website, login in to your vault and edit it.
|
|
4. Select the corresponding type (text, hidden or boolean) and then press the blue "+" icon.
|
|
<img width="60%" src="../../images/features/custom-fields/types.png">
|
|
5. In the "Name" field paste the element ID.
|
|
6. In the "Value" field enter your info you want auto-filled.
|
|
7. Save the entry.
|
|
|
|
## Special name prefixes for auto-filling
|
|
|
|
When Bitwarden searches a webpage's form elements to match with your custom field's name, an exact, case-insensitive comparison is done. For example, if your custom field has the name "PIN", the following form element's values (from the id, name, label, etc) will match for auto-filling: "pin", "PIN", and "Pin". However, values such as "pin2" or "mypin" will not match.
|
|
|
|
There are two special name prefixes that can give you even more control over how your custom field is auto-filled:
|
|
|
|
**CSV**
|
|
|
|
Prefixing your custom field's name with `csv=` allows you to specify multiple names to search for and compare when an auto-fill is performed.
|
|
|
|
Example:
|
|
|
|
`csv=pin,pin2,mypin` will match all of the examples above.
|
|
|
|
**Regular Expressions**
|
|
|
|
Prefixing your custom field's name with `regex=` allows you to perform [regular expression](https://regexone.com/){:target="_blank"} comparisons when an auto-fill is performed.
|
|
|
|
Example:
|
|
|
|
`regex=pin` will match all of the examples above.
|
|
|
|
Example:
|
|
|
|
`regex=^first.*name` will match "firstName", "First_name", and "First Name".
|