help/_articles/features/folders.md

layout, title, categories, featured, popular, tags, order

layout	title	categories	featured	popular	tags	order
article	Folders	account-management	false	false	categories folders sub-folders	06

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.

{% callout success %} Items added to a Folder will still appear in your Vault when {% icon fa-th %} All Items is selected from the Filter menu, and deleting a Folder will not delete the items in that Folder. {% endcallout %}

Create a Folder

Folders can be created, renamed, and deleted from any Bitwarden client application:

• Web Vault
• Browser Extension
• Desktop
• Mobile
• CLI

{% capture web_vault %} ### Web Vault

To create a Folder, select the {% icon fa-plus %} Add icon in the Folders list:

{% image manage-items/folder-add-web.png Add a folder %}

Once created, you can rename or delete a folder at any time using the hover-over {% icon fa-pencil %} Pencil icon.

{% endcapture %} {{ web_vault | markdownify}}

{% capture browser_extension %} ### Browser Extension

To create a Folder, select the {% icon fa-cogs %} Settings menu, select the Folders option, and tap/select the {% icon fa-plus %} Add icon:

{% image manage-items/folder-add-extension.gif Add a folder %}

Once created, you can rename or delete a folder at any time from the same menu by selecting an existing folder.

{% endcapture %} {{ browser_extension | markdownify}}

{% capture desktop_info %} ### Desktop App

To create a Folder, select the {% icon fa-plus %} Add icon in the Folders list:

{% image manage-items/folder-add-desk.png Add a folder %}

Once created, you can rename or delete a folder at any time using the hover-over {% icon fa-pencil %} Pencil icon.

{% endcapture %} {{ desktop_info | markdownify}}

{% capture mobile_info %} ### Mobile App

To create a Folder, tap the {% icon fa-cogs %} Settings menu, tap the Folders option, and tap/select the {% icon fa-plus %} Add icon:

{% image manage-items/folder-add-mob.jpeg Add a folder %}

Once created, you can rename or delete a folder at any time from the same menu by tapping an existing folder.

{% endcapture %} {{ mobile_info | markdownify}}

{% capture cli_info %} ### 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.

{% endcapture %} {{ cli_info | markdownify}}

{% callout info %} 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. {% endcallout %}

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.

{% callout info %} 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]({% link _articles/features/searching-vault.md %}). {% endcallout %}

{% image manage-items/subfolders.png 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
• Browser Extension
• Desktop
• Mobile
• CLI

{% capture web_vault %} ### 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:

  {% image manage-items/add-to-folder.png Move item to a Folder%}

• Navigate to the My Vault view, select the Vault items you want to move and use the top-level {% icon fa-cog %} gear dropdown to select the {% icon fa-share %} Move Selected button. On the Move Selected dialog box, choose the Folder you want to move the item(s) to:

  {% image manage-items/add-to-folder-move.png Move item to a Folder %}

{% endcapture %} {{ web_vault | markdownify}}

{% capture browser_extension %} ### Browser Extension

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

{% image manage-items/folder-move-be.png Move item to a folder %}

{% endcapture %} {{ browser_extension | markdownify}}

{% capture desktop_info %} ### Desktop App

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

{% image manage-items/folder-move-desk.png Move item to a folder %}

{% endcapture %} {{ desktop_info | markdownify}}

{% capture mobile_info %} ### Mobile App

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

{% image manage-items/folder-move-mob.jpeg Move item to a folder %}

{% endcapture %} {{ mobile_info | markdownify}}

{% capture cli_info %} ### 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

{% callout success %} 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{:target="_blank"}.
• 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. {% endcallout %}

{% endcapture %} {{ cli_info | markdownify}}

{% callout success %} 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). {% endcallout %}