Create a project

Every workspace that has projects enabled will have an initial untitled project which contains all the workspace's repositories. To start, give this initial project a meaningful name which you can reference as you create new projects and begin moving repositories. You must have workspace administration permissions to create projects.

To create a project:

1. Select the Create button.

2. Select Project from the dropdown menu.

3. Select the Workspace for the project. 

4. Give the project a Name that is short and easily identifies the work your team will do in the project. The project name populates menus and dashboards.

5. Note or modify the Key field. The key acts as a unique identifier used in the project URL.

6. Add a meaningful description which describes the focus of the project. You can see the project description when viewing a list of projects.

7. Select This is a private project if you only want the project name displayed to members of your workspace. For more information, see the info box below.

8. Click Change avatar to add or change a custom avatar.

9. Click Create project.

You can now add repositories to the project you just created using either the Create repository or Add existing repositories.