Create a project

Only workspace administrators can create a project.

To create a project:

  1. Select the Create button.

  2. Select Project from the dropdown menu.

  3. 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.

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

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

  6. 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.

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

  8. Click Create project.

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

Private and public projects

Projects can be either visible or hidden from public view. Access to the members of your workspace and the repositories in the project are what determines access to the project itself.

Private projects

  • Can only contain private repositories.

  • Repositories will only be visible to people who have access to the project in question.

  • The title and details of a private project will only be visible to members of the workspace and people who have access to a repository in the project.

Public projects

  • Are visible to anyone. However, the repositories contained in a public project can be private and hidden from public view.

Usage limits

  • Default reviewers: 30 default reviewers per project.

  • Branch restrictions: 70 branch restrictions per project; 20 users per branch restrictions; 10 groups per branch restriction.

Still need help?

The Atlassian Community is here for you.