Using Attachments

2 min readJun 7, 2021

Buttercup supports adding attachments by dragging and dropping local files onto a target entry. Vaults that support attached files show a small attachment-drag area to indicate that attachments can be added.

Attachment drop-zone on Buttercup for Desktop

At the time of writing only file and WebDAV vault types support attachments, but support is planned for Dropbox and Google Drive as well.

Note that attachments support is brand new, and with all new features it should be used with care. It is your responsibility to keep your vault and attached files backed-up. Do not attach anything that you do not already have stored elsewhere, for safety.

Attached files are encrypted when added, and then written to a location next to the vault. Encrypted attachment files are stored in a .buttercup directory in the same parent directory as the current .bcup vault file. This is the same for all vault types so that the same vault’s attachments can be accessed when adding the vault to a Buttercup application using any available vault source type.

Buttercup restricts the upload/download size of attachments based upon the application environment. Desktop’s limit is 20MB at the time of writing. This is to ensure application responsiveness and stability. Encrypted attachments are processed in-memory.

It may take a little longer to upload/add attachments on some services, such as certain WebDAV providers. It is vital that you do not close Buttercup while the attachment is being added.

Any time of file can be added, but only certain file types (like images) can be previewed.




Free, accessible, cross-platform password manager for everyone. Manage your secrets easily on every device — never be locked out.