mirror of
https://github.com/bitwarden/help
synced 2025-12-14 07:13:19 +00:00
aa9e70659a
* Staging: Vault Mgmt (#380) * Commit #1 - Updated Master Password article, and removed old versions (w/ redirects) - Repurposed Account Encryption Key Article - Moved Fingerprint Phrase article - Requisite re-ordering of security articles - Change "Account Mgmt" title to "Your Vault" - Slight change to "Import & Export" category title * - Managing Items - Favorites & Folders (+images) - Sync & Search (+images) - Import Export title change - Clarification re: Login v. Lock in "Field Guide to Two-step Login" - Clarifiation re: Org Invite Expiry in managing-users.md - New link to Acct. Encryption Key in encrypted-export.md * Commit #3 -Custom Fields - URIs (+ images) - File Attachments - VH Reports - Required re-ordering * Commit #4 -BWDC Login recommendation -VH Reports images - Added Two-step FAQs, Import FAQs - FAQ Nav Item depricated, targetting FAQs for each category are now the last article within respective categories * Commit #5 -Edit & move Account/Org Deletion Article -config.yml to re-order global nav -encrypted export update * General FAQs (preliminary edits) * Features > Misc. * return forgot-master-password.md & downstream order changes * delete account warning * fixed link
70 lines
3.4 KiB
Markdown
70 lines
3.4 KiB
Markdown
---
|
|
layout: article
|
|
title: Custom Fields
|
|
categories: [account-management]
|
|
featured: false
|
|
popular: false
|
|
tags: [fields, autofill, custom fields]
|
|
order: 08
|
|
---
|
|
|
|
Custom fields, available for any [Vault item type]({% link _articles/account/managing-items.md %}), allow you to store additional well-structured data fields for a Vault item. Custom fields are saved as `Name:Value` pairs, and can be one of three types:
|
|
|
|
- **Text**: Field value stores a freeform input (text, numbers, etc.)
|
|
- **Hidden**: Field value stores freeform input that is hidden from view (particularly useful for Organizations using the [Hide Password access control](https://bitwarden.com/help/article/user-types-access-control/#granular-access-control)).
|
|
- **Boolean**: Field value stores a boolean value (true/false).
|
|
|
|
## Auto-fill Custom Fields
|
|
|
|
The **Name** specified for a custom field is critical to successfully setting up auto-fill for custom fields. When naming the custom field, you should use one of the following HTML form element attributes/values:
|
|
|
|
1. HTML form element's `id` attribute.
|
|
2. HTML form element's `name` attribute.
|
|
3. HTML form element's corresponding `label` value.
|
|
4. HTML form element's `aria-label` attribute.
|
|
5. HTML form element's `placeholder` attribute.
|
|
|
|
Bitwarden will search the matched-URI webpage for those HTML form element attributes/values **in the above priority-order**. If a custom field's name matches one of those attributes/values, auto-fill will be available into that HTML form element.
|
|
|
|
### Name to Attribute Matching
|
|
|
|
Field Name to attribute/value matches is **exact** and **case-insensitive** comparison. For example, if your custom field has the name `PIN`:
|
|
|
|
- **Auto-fill offered** for `pin`, `PiN`, `PIN`, etc.
|
|
- **Auto-fill not offered** for `pin2` or `mypin`
|
|
|
|
### Field Name Prefixing
|
|
|
|
There are two cases in which you can exercise more control over [name to attribute mapping](#name-to-attribute-mapping) by using prefixes.
|
|
|
|
#### csv
|
|
|
|
Prefixing your custom field's name with `csv=` allows you to specify multiple names to search for and compare to when auto-fill is performed. For example:
|
|
|
|
`csv=pin,pin2,mypin` will offer auto-fill for all the above examples.
|
|
|
|
#### regex
|
|
|
|
Prefixing your custom field's name with `regex=` allows you to perform [regular expression comparisons](https://regexone.com/){:target="_blank"} when auto-fill is performed. For example:
|
|
|
|
`regex=pin` will offer auto-fill for all the above examples.
|
|
|
|
`regex=^first.*name` will offer auto-fill for `firstName`, `First_name`, and `First Name`
|
|
|
|
### Example Auto-fill Configuration
|
|
|
|
Follow this procedure to correctly configure a custom field for auto-fill. This example uses Google Chrome for its Developer Tools.
|
|
|
|
{% image /features/custom-fields/custom_field.gif %}
|
|
|
|
1. On the webpage that matches the Login item's URI, right-click the field you want to auto-fill to and select **Inspect**.
|
|
|
|
The HTML element will open and be highlighted in the Developer Console.
|
|
2. Find and copy the element `id` (find `id="xxx"`, where `xxx` is the element's `id` value).
|
|
3. In the relevant Vault item's **Custom Fields** section, choose the appropriate field type and select the {% icon fa-plus %} **New Custom Field** button:
|
|
|
|
{% image /features/custom-fields/types.png %}
|
|
4. Paste the copied element `id` in the **Name** field.
|
|
5. Specify the desired information to be auto-filled (in the above example, a PIN) in the **Value** field.
|
|
6. Save the Vault item.
|