82ecf7def2
* initial draft * codeblock e.g.'s * initial draft of f4e end-user doc * first round of feedback * feedback round 2 * feedback round 3 * update screenshots * safari/macos import guide sketch * adios, friendly name * cli note * fix typo * finish import from macos/safari * feedback round 4 * more feedback * updated diagrams * fix typo * linked custom fields & more release note items * new auto-fill unlock behavior for context menu & keyboard! * release notes - autofill unlock * new events * fixes to 'using sso' * updated KC screenshot & test step * KC URL * send extension & release notes * hide ios extension * updates to sso faqs * SEO desc's & tags * Key Connector > Impact on Unlock > Add a note for online dependency * clarify "account is lost" * add some references to CME * final edits * f4e * quick edit to RN
3.6 KiB
layout, title, categories, order, featured, popular, tags
| layout | title | categories | order | featured | popular | tags | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| article | Auto-fill Custom Fields |
|
05 | true | false |
|
Bitwarden can do more than just auto-fill your usernames and passwords! Bitwarden Browser Extensions can auto-fill custom fields to simplify fill-in of security questions, PINS, and more using the unique Tab view).
Additionally, if your Browser Extension is having issues auto-filling usernames and passwords for a particular site, using Linked custom fields can force an auto-fill.
Auto-fill Custom Fields
{% callout success %} It's important to name the custom field correctly in order for auto-fill to work (learn more). {% endcallout %}
To auto-fill custom fields:
-
Open the Browser Extension or, if your Browser Extension is already open, navigate to the {% icon fa-folder %} Tab view.
The Tab view automatically detects the URI (e.g. myverizon.com) of the page displayed in the open tab and surfaces any Vault items with corresponding URIs.
-
Select the item that contains the custom field you want to auto-fill:
{% image autofill/auto-fill-custom-field.png Item with a Custom Field %}
The Browser Extension will find any fields that match the custom field name and auto-fill that field's value.
Using Linked Custom Fields
Linked custom fields can be used to solve issues where your Browser Extension can't auto-fill usernames and passwords for a particular site. To create and auto-fill a Linked custom field:
-
In the Custom Fields section of a Vault item's Edit Item panel, choose Linked from the dropdown and select {% icon fa-plus %} New Custom Field:
{% image features/linked-custom-field.png Add a Linked Custom Field %}
-
In the Name input, give the custom field a name that corresponds to the username or password's HTML form element
id,name,aria-label, orplaceholder.{% callout success %}You can get the right value by right-clicking the form element and using the Copy Custom Field Name context menu option:
{% image features/custom-fields-contextmenu.png %}{% endcallout %} -
From the Value dropdown, select Username or Password depending on which credential you're having trouble auto-filling. In many cases, you'll need to create a Linked custom field for each.
-
Save the changes to your Vault item.
Now that you've created one or more Linked custom fields, you can auto-fill using the method described in an earlier section. When you do, your Browser Extension will auto-fill the username, password, or both into the HTML form element given for a field Name.
Special Auto-fill Scenarios
HTML <span> Elements
Typically custom fields are auto-filled in HTML <form> or <input> elements, however Bitwarden Browser Extensions can auto-fill custom field values into the innerText of HTML <span> elements as well.
In order to auto-fill into a <span> element, the opening tag must have the data-bwautofill attribute. So, in the following scenario:
<span data-bwautofill id="myspan">Bitwarden is great.</span>
A custom field with name: myspan will replace Bitwarden is great with whatever is saved in the custom field's value.