Help Center

File Attachments

File Attachments

Files can be attached to vault items from any Bitwarden app. An individual file attachment must be 500 MB (100 MB if uploading from mobile) or smaller.

Paid users and members of paid Organizations have 1GB of encrypted storage for file attachments. More storage can be purchased in 1GB increments.

Upload a File

To attach a file to a vault item:

Web Vault

To attach file from the web vault:

  1. Hover-over the vault item to attach the file to and select the Gear icon.

  2. Select Attachments from the dropdown.

  3. In the Attachments panel, Browse... for your file.

  4. Select the Save button.

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

Browser Extension

To attach file from the browser extension:

  1. Open the item to attach the file to and select the Edit button.

  2. Select Attachments.

  3. On the Attachments panel, Browse... for your file.

  4. Select the Save button.

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

Mobile

To attach file from the mobile app:

  1. Open the item to attach the file to and select the Menu button.

  2. Select Attachments.

  3. On the Attachments panel, select the Choose File button and browse for your file.

  4. Select the Save button.

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

Desktop

To attach file from the desktop app:

  1. Open the item to attach the file to and select the Edit button.

  2. Select Attachments.

  3. On the Attachments panel, Browse... for your file.

  4. Select the Save button.

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

CLI

Use bw create attachment to attach a file to an existing vault item, for example:

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

For more information, refer to our CLI documentation.

Download a File

To download a file attachment:

Web Vault

To download an attachment from the web vault:

  1. Hover-over the vault item with the attachment to download and select the Gear icon.

  2. Select Attachments from the dropdown.

  3. Select the attachment to download. Depending on the file type, some attachments might open directly in your browser.

Browser Extension

To download an attachment from the browser extension:

  1. Open the item with the attachment to download.

  2. Scroll to the Attachments section and select the Download button for the item to download.

Mobile

To download an attachment from the mobile app:

  1. Open the item with the attachment to download.

  2. Scroll to the Attachments section and select the Download button for the item to download.

Desktop

To download an attachment from the desktop app:

  1. Open the item with the attachment to download.

  2. Scroll to the Attachments section and select the Download button for the item to download.

CLI

Use bw get attachment to download a file, for example:

bw get attachment photo.png --itemid 99ee88d2-6046-4ea7-92c2-acac464b1412 --output /Users/myaccount/Pictures/

For more information, refer to our CLI documentation.

Delete a File

To delete a file attachment:

Web Vault

To delete an attachment from the web vault:

  1. Hover-over the vault item with the attachment to delete and select the Gear icon.

  2. Select Attachments from the dropdown.

  3. Hover-over the attachment to delete and select the Delete icon.

Browser Extension

To delete an attachment from the browser extension:

  1. Open the item with the attachment to delete and select the Edit button.

  2. Select Attachments.

  3. On the Attachments panel, select the Delete icon for the attachment to delete.

Mobile

To delete an attachment from the mobile app:

  1. Open the item with the attachment to delete and select the Menu icon.

  2. Select Attachments.

  3. On the Attachments panel, select the Delete icon for the attachment to delete.

Desktop

To delete an attachment from the desktop app:

  1. Open the item with the attachment to delete and select the Edit button.

  2. Select Attachments.

  3. On the Attachments panel, select the Delete icon for the attachment to delete.

CLI

Use bw delete attachment to delete a file attachment, for example:

bw delete attachment 7063feab-4b10-472e-b64c-785e2b870b92

For more information, refer to our CLI documentation.

Add Storage Space

Paid users and members of paid Organizations have 1GB of encrypted storage for file attachments. Individuals and Organizations can purchase additional storage space by completing the following steps:

note

Adding storage space will adjustment your billing totals and immediately charge your payment method. The first change will be prorated for the remainder of the current billing cycle.

Individual

To add storage space to your personal vault:

  1. Open 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.

Organization

To add storage space to your Organization vault:

  1. Open the web vault and navigate to your Organization.

  2. Select the Settings tab.

  3. From the Settings menu, select Subscription.

  4. In the Storage section, select the Add Storage button.

  5. Using the counter, choose the number of GB of Storage to Add and select Submit.