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.
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.
- 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.
- 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:
- Click Projects > Create project.
- 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.
- 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.
- Note or modify the Key field. The key acts as a unique identifier used in the project URL.
- 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.
- 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
- Click Change avatar to add or change a custom avatar.
- 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
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.
To add an existing repository to a project
- Navigate to the repository you want to add to your project.
- Click the settings icon.
Select the project, from the Project menu, where you want to move the repository.
- 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:
- Click Teams>your team name.
- Click Projects on the team dashboard page.
- 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
- Navigate to the project you want to modify.
- Click Settings.
- Do one of the following:
- 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.
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.
- Select the Description field to modify the project description. The description appears on dashboards and the project landing page.
- Select or clear the Privacy box to change the status of the project. A project is private when you select the option.
- 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:
- Click Projects>your project name.
- Click Settings.
- Click Delete project located in the upper right of the page.
Was this helpful?
Thanks for your feedback!