Organising projects into folders
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:
- Open the project and go to its Settings page.
- Choose a folder from the Folder dropdown. To remove a project from a folder, select No folder.
- 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.