If your account has a lot of projects, you can group them into **folders** to keep the projects list organised. Folders are specific to your account, and each project can belong to a single folder.

## How folders appear

On the **Projects** page, a sidebar lists **All Projects**, your **Favourites**, each of your folders, and **Ungrouped** (projects that have not been placed in a folder). Selecting an entry filters the list to show just those projects, so you see one view at a time rather than every project at once.

Folders are listed alphabetically by name. In the **All Projects** view, your favourite projects float to the top so they are always easy to find, regardless of which folder they belong to.

Searching works across every project, so you can find one quickly without needing to remember which folder it is in.

## Assigning a project to a folder

You assign a project to a folder from the project's own settings:

1. Open the project and go to its **Settings** page.
2. Choose a folder from the **Folder** dropdown. To remove a project from a folder, select **No folder**.
3. Save your changes.

You can also drag a project onto a folder in the sidebar to move it there.

## Creating and managing folders

You can create, rename, and delete folders from the sidebar. Folders are always shown alphabetically, so there is no manual ordering to manage.

Deleting a folder does not delete the projects inside it. Any projects that were in the folder simply become ungrouped, where you can reassign them to another folder at any time.

## Who can manage folders

Any user who can create projects can create a new folder, since creating an empty folder does not affect any existing projects.

Renaming or deleting a folder, however, affects projects across the whole account, so it requires access to every project in the account. This means account administrators and users granted access to all projects can rename and delete folders. A user whose access is limited to specific projects, or who has been excluded from any project, cannot rename or delete folders.

## Managing folders via the API

Folders are also available through the DeployHQ API, where they are identified by an `identifier`. You can list, create, rename, and delete folders, and you can assign a project to a folder by passing the folder's identifier when updating the project. See the API documentation for the full set of folder endpoints.