File Attachments

Category: Your Vault
On this page:

    Files can be attached to Vault items from any Bitwarden application. An individual file attachment must be 500 MB (100 MB if uploading from Mobile) or smaller. By default, paid users have access to 1GB of encrypted storage for file attachments. Additional storage can be purchased in 1GB increments.

    Note

    File Attachments are available for Premium users, including members of Paid Organizations (Families, Teams, or Enterprise).

    Attach a File

    To attach a file to a Vault item from a Bitwarden application:

    Attach from Web Vault

    Complete the following steps to attach a file to a Vault item from the Web Vault:

    1. Hover-over the Vault item you’d like to attach a file to, and select the Gear icon.
    2. Select Attachments from the dropdown.
    3. In the Attachments dialog box, Browse… for your file.
    4. Select the Save button to finish attaching a file.

    Once a Vault item has a file attached to it, selecting Attachments from the Gear dropdown will also display a list of attached files.

    Attach from a Browser Extension

    Complete the following steps to attach a file to a Vault item from a Bitwarden Browser Extension:

    1. Open the item you’d like to attach a file to, and select the Edit button.
    2. Select Attachments.
    3. On the Attachments page/dialog, Browse… for your file.
    4. Select the Save button to finish attaching a file.

    Once a Vault item has a file attached to it, selecting Attachments from will also display a list of attached files.

    Attach from Mobile

    Complete the following steps to attach a file to a Vault item from a Bitwarden Mobile App:

    1. Open the item you’d like to attach a file to, and select the Menu button.
    2. Select Attachments.
    3. On the Attachments page, select the Choose File button and browse for your file.
    4. Select the Save button to finish attaching a file.

    Once a Vault item has a file attached to it, selecting Attachments from the Menu dropdown will also display a list of attached files.

    Attach from Desktop

    Complete the following steps to attach a file to a Vault item from a Bitwarden Desktop App:

    1. Open the item you’d like to attach a file to, and select the Edit button.
    2. Select Attachments.
    3. On the Attachments page/dialog, Browse… for your file.
    4. Select the Save button to finish attaching a file.

    Once a Vault item has a file attached to it, selecting Attachments from will also display a list of attached files.

    Attach from the CLI

    Use bw create attachment to attach a file to an existing Vault item, for exaple:

    bw create attachment --file /path/to/myfile.ext --itemid <itemid>
    

    For more information, refer to our CLI documentation.

    Warning

    A note on Attachments created after May 11, 2021:

    As a result of an Attachment upgrade, Attachments uploaded on the newest clients cannot be opened on older client versions. If you find you’re unable to access a recently-created Attachment, upgrade your client to the newest version (Hint: The Cloud Web Vault is always on the newest version.)

    View an Attachment

    Viewing an attachment mimics the same procedure used to attach a file. Refer to one of the above sections for help.

    Add Storage Space

    By default, users with a Premium subscription have access to 1GB of encrypted storage for file attachments. Additional storage can be purchased in 1GB increments. Complete the following steps to purchase additional storage:

    1. In the Web Vault, select the Settings tab.
    2. From the Settings menu, select Premium Membership.
    3. In the Storage section, select the Add Storage button.
    4. Using the counter, choose the number of GB of Storage to Add and select Submit.

    Adding storage will result in adjustments to your billing totals and immediately charge your payment method on file. The first change will be prorated for the remainder of the current billing cycle.

    Note

    A note about attachments created prior to December, 2018:

    Prior to December 2018, File Attachments used a different method of encrypting their data. We have since moved to a newer, better way of encrypting File Attachments. Any attachments that use the older encryption method will be labeled with an alert icon in your vault listing. You should upgrade these old attachments to the newer method of encryption so that other account-related features can function properly:

    1. Open the page for editing your attachments (see above instructions).
    2. Click the Fix button next to the old attachment. This process will download the attachment, re-encrypt it using the new encryption method, re-upload the attachment back to your vault, and delete the old version of the attachment.

    Once an attachment has successfully been upgraded, the alert icon and fix button should disappear.