File Attachments
note
File attachments are available for Premium users and members of paid organizations. These upgraded plans include 5GB of encrypted storage for file attachments per user. More storage can be purchased in 1GB increments.
Files can be attached to any vault item, including shared vault items, from any Bitwarden app. A file of any type that's 500 MB or smaller (100 MB or smaller, if uploading from mobile) can be attached to an item and up to 5 GB of total attachments (unless more storage is added) can be uploaded per account. Attachments are encrypted and decrypted locally, meaning no unencrypted attachment data is transported over the internet or stored by the server.
note
Attachments on individual vault items and all Sends use the individual storage space granted by premium subscriptions or organizations. Attachments on organization owned items use shared organizational storage space. Learn how to add storage space.
Upload a file
To attach a file to a vault item:
To attach a file from the web app:
Open the item and select Edit.
Scroll to the bottom of the Edit view and select Attachments.
Select Choose File and browse for your file.
Select Upload.
Select Save.
Once saved, the Attachments section will list all files attached to that item.
Download a file
To download an attachment from most Bitwarden apps, open the item. Within the Attachments section, select the Download icon next to the file.
For the CLI, use bw get attachment to download a file, for example:
Bashbw get attachment photo.png --itemid 99ee88d2-6046-4ea7-92c2-acac464b1412 --output /Users/myaccount/Pictures/For more information, please refer to the CLI documentation.
Export all attachments
To create an export that includes attachments:
To export your attachments from the web app:
Select Tools → Export from the navigation:
Export items From the File format dropdown, select
.zip (with attachments). Currently, attachments can only be exported from your individual vault.Select Export. You will need to confirm your permission to do this using your master password or an email verification code.
Your export file will be sent to your Downloads folder or wherever your web browser is set to download files to.
Delete a file
To delete a file attachment:
To delete an attachment from the web app:
Open the item and select Edit.
Scroll to the bottom of the Edit view and select Attachments.
Select the Delete icon next to the attachment.
Select Yes to confirm.
Select Save.
Add storage space
Paid users and members of paid organizations have 5GB of encrypted storage for file attachments. Individuals and organizations can purchase additional storage space by completing the following steps:
note
Adding storage space will adjust your billing totals and immediately charge your payment method. The first charge will be prorated for the remainder of the current billing cycle.
To add storage space in your individual vault:
In the Bitwarden web app, navigate to Settings → Subscription.
In the Storage section, select the Add Storage button:
Add storage to individual vault Using the counter, choose the number of GB of Storage to Add and select Submit.
Fixing old attachments
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 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:
Open the vault item containing the old attachment and select Edit.
Scroll to the bottom of the Edit form and select Attachments.
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.