Projects

Bitbucket Cloud projects make it easier for teams to focus on a goal, product, or process by organizing your repositories into projects.

Projects and Bitbucket teams

You must have a Bitbucket team to use projects. For more information see, Bitbucket Cloud Teams.

Only team administrators can create a project.

Private and public projects

Projects can be either visible or hidden from public view. Access to the team, and the repositories in the project, are what determines access to the project itself.

Private projects

  • Can only contain private repositories.
  • Repositories and their associated wiki and issue tracker will only be visible to people who have access to the repository in question.
  • The title and details of a private project will only be visible to team members 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.
  • Allow you to host public issue trackers and wiki's in public repositories.

Create a project

Every team which has projects enabled will have an initial untitled project which contains all the team'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 team administration permissions to create projects.

To create a project:

  1. Click Projects > Create project.
  2. Select the Owner of the project. Projects are only available in Bitbucket teams so the Owner of a project must be a Bitbucket team and only team administrators can create projects for the team.
  3. Give the project a name which 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 in the team dashboard.
  6. Select This is a private project if you only want the project name displayed to members of your team. For more information see, Private and public projects
  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 a repository or Add existing repositories

Add repositories to a project

If you want to add a repository to a project it must already be owned by the team. To change ownership of a repository see, Change or transfer repository ownership.

There are several ways to add repositories to a project:

  • In a new project you can use the Add existing repositories link, which will display a list of repositories the team owns.
  • In the repository settings you can change the Project field to a different project, which will move the repository to that project.
  • Use the Create repository link on the Projects dashboard or from the Repositories menu. Once you have projects enabled you'll have to select a project for every new repository.

You cannot move a public repository to a private project.

To add an existing repository to a project

  1. Navigate to the repository you want to add to your project.
  2. Click the settings icon.
  3. Select the project, from the Project menu, where you want to move the repository.

  4. Click Save repository details

You'll see that the project changes in the breadcrumb links at the top of the page. Click the second link to navigate to the project recently assigned to the repository.

Find and share projects

The fastest way to find a project you are currently working in is to click Projects>your project name.

Find a project in a team:

  1. Click Teams>your team name
  2. Click Projects on the team dashboard page.
  3. Select the project you want to view.

Finding the project from the breadcrumb links in a repository

If you know the repository you're looking for, but not the project, just navigate to the repository and in the breadcrumb links at the top of the page you will see: the team name / the project name / the repository name. Just click on the project name to see the project landing page and any repositories in the project to which you have access.

Sending a project link to someone

You can copy the URL of the project landing page and send that link to anyone that can access the project. The format of the link should look similar to this example: https://bitbucket.org/account/user/teamsinspace/projects/MS.

Manage and edit existing projects

You can change your projects avatar, privacy setting, name, key, and description with a few simple steps.

To modify project settings

  1. Navigate to the project you want to modify.
  2. Click Settings.
  3. Do one of the following:
    1. Select the Name field to modify the name of the project. Remember this will modify how the project appears in menus and dashboards so be sure your team is aware of the changes.
    2. Select the Key field to modify the project key. The key acts as a unique identifier for the project for menu, dashboard, and breadcrumb links.

      During this initial release of projects changing the Key field has a very low to no impact on your project and how Bitbucket functions. However the key will become a more important attribute as we continue to improve projects.

    3. Select the Description field to modify the project description. The description appears on dashboards and the project landing page.
    4. Select or clear the Privacy box to change the status of the project. A project is private when you select the option.
    5. Click Change avatar, then drag an image (*.png, *.jpg, or *.gif) into the field, and click Save to add a custom avatar.

Delete a project

To delete a project first you must remove or delete all the repositories contained within the project. Once you've done that you can delete the project by doing the following:

  1. Click Projects>your project name.
  2. Click Settings.
  3. Click Delete project located in the upper right of the page.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport