Folders
Folders are structures used to organize your Personal Vault by gathering together Logins, Cards, Identities, and Secure Notes. Using Folders is a great way to make all Vault items easy to find. Any Vault item can be added to a Folder, including items shared with you from an Organization.
Tip
Items added to a Folder will still appear in your Vault when All Items is selected from the Filter menu, and deleting a Folder will not delete the items in that Folder.
Create a Folder
Folders can be created, renamed, and deleted from any Bitwarden client application:
Web Vault
To create a Folder, select the Add icon in the Folders list:
Once created, you can rename or delete a folder at any time using the hover-over Pencil icon.
Browser Extension
To create a Folder, select the Settings menu, select the Folders option, and tap/select the Add icon:
Once created, you can rename or delete a folder at any time from the same menu by selecting an existing folder.
Desktop App
To create a Folder, select the Add icon in the Folders list:
Once created, you can rename or delete a folder at any time using the hover-over Pencil icon.
Mobile App
To create a Folder, tap the Settings menu, tap the Folders option, and tap/select the Add icon:
Once created, you can rename or delete a folder at any time from the same menu by tapping an existing folder.
CLI
To create a Folder, use the command:
bw create folder <foldername>
You can edit an existing folder using bw edit <folderId>
and delete one using bw delete folder <folderId>
. For more information, refer to our CLI documentation.
Note
If you’re a member of an Organization, Collections will be shown below your Folders in the Filters menu.
There are similarities between Folders and Collections. Folders organize your Personal Vault (but can include shared items) and are unique to you, where Collections are shared between members of Organizations.
Nested Folders
Folders can be “nested” in order to logically organize them within your Vault. There’s no limit to the depth with which you can nest Folders, but creating too many levels may interfere with your Vault’s interface.
Note
Searching inside a “parent” Folder will not include items in Folders nested inside it as potential search results. For more information, see Search your Vault.
To create a nested Folder, give a new Folder a Name that includes the “parent” Folder following by a forward slash (/
) delimiter, for example Personal/Email
.
If there is no Folder with the corresponding “parent” name, the Folder won’t nest and its title will be displayed in-full.
Move Items to a Folder
Once you’ve created a Folder in your Vault, there are a few ways to move items to it:
Web Vault
From the Web Vault, you can either:
-
Navigate to the Add Item or Edit Item screen, select your new folder from the Folder dropdown and Save your item:
-
Navigate to the My Vault view, select the Vault items you want to move and use the top-level gear dropdown to select the Move Selected button. On the Move Selected dialog box, choose the Folder you want to move the item(s) to:
Browser Extension
Open the Vault item you want to move, select the Folders dropdown, and choose the folder to move the item to:
Desktop App
Open the Vault item you want to move, select the Folders dropdown, and choose the folder to move the item to:
Mobile App
Open the Vault item you want to move, tap the Folders dropdown, and choose the folder to move the item to:
CLI
Use the bw edit
command to manipulate the folderId
attribute of the Vault item JSON object, as in the following example:
bw get item 7ac9cae8-5067-4faf-b6ab-acfd00e2c328 | jq '.folderId="3d9cecac-71a2-4637-9341-acf000eedf04"' | bw encode | bw edit item 7ac9cae8-5067-4faf-b6ab-acfd00e2c328
Tip
Using edit
will require you to:
- Use the
get
command with the exactid
of the item you want to edit. - Know the exact
folderId
of the folder you want to move it to. - Manipulate the JSON object (specifically, the
folderId
attribute) with a command-line JSON processor like jq. - Use the
encode
command to encode changes to the JSON object.
If you’re unfamiliar with using any of these parts, refer to our CLI documentation.
Tip
Items shared with you from an Organization can be added to your personal Folders, and doing so will only impact how the item appears in your Personal Vault (i.e. adding an item to a Folder won’t give anyone access to that Folder, or change whether it’s in a Folder in their Vaults).