Folders

Category: Your Vault
On this page:

    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:

    Add a folder
    Add a folder

    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:

    Add a folder
    Add a folder

    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:

    Add a folder
    Add a folder

    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:

    Add a folder
    Add a folder

    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.

    Nested folders
    Nested folders

    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:

      Move item to a Folder
      Move item to a Folder
    • 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:

      Move item to a Folder
      Move item to a Folder

    Browser Extension

    Open the Vault item you want to move, select the Folders dropdown, and choose the folder to move the item to:

    Move item to a folder
    Move item to a folder

    Desktop App

    Open the Vault item you want to move, select the Folders dropdown, and choose the folder to move the item to:

    Move item to a folder
    Move item to a folder

    Mobile App

    Open the Vault item you want to move, tap the Folders dropdown, and choose the folder to move the item to:

    Move item to a folder
    Move item to a folder

    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 exact id 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).