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 details

1. Navigate to the project you want to modify.

2. Select Project settings in the left sidebar.

3. Select Project details in the left sidebar.

4. 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 the members of the workspace are 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.

      Note: 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. Navigate to the project you want to modify.

2. Select Project settings on the left sidebar.

3. Select Project details on the left sidebar.

4. Select Delete project located in the upper-right corner of the page, then Delete in the confirmation dialog.