Configure defaults for issue fields

Repository administrators can configure the components, milestones, and versions associated with a project's issues. When creating issues, users select these values from their corresponding dropdown lists.  You can specify defaults for each as well. For example, you can configure a General component to use as a default. If a user doesn't choose a component, the system automatically sets the component for the user.

The issue tracker is a light weight feature. If you want a sophisticated issue tracker, you should look into connecting Bitbucket Cloud to Jira Software using the Jira DVCS Connector.  Atlassian has Jira Software subscriptions starting at $10.00 a month.

Deleting existing issue configurations

After you create a component, milestone, or version, users can start using them immediately. Later, you can delete a configuration from the issue tracker. For example, you can create an issue component called Oracle and later remove it. When you remove it, Bitbucket does the following:

  • locates issue's that use it

  • remove the component type

  • leaves the issue's component value empty

  • adds a comment to the issue explaining the change

Bitbucket does the same procedure if you create a milestone or version and later remove them.  

Component configuration

You use components to divide project issues into logical groups. Examples of component names:

  • User Interface

  • Installer

  • Documentation

  • Plugins

  • Macros

To configure components, do the following:

  1. Go to the repository settings.

  2. Click Issue tracker from the left hand tabs.

  3. Enter the name of the component in the Components section.

  4. Click Add component.

Milestone configuration

A milestone is usually seen as a subset of a version. It is a point that the development team works towards. It corresponds to a short period of time in which the development team implements and delivers a discrete product increment, such as a working milestone release. Examples of milestones:

  • M1

  • M2

  • V1.1.m1

  • V1.1.m2

The system sorts milestones alphabetically.  To add a milestone, do the following:

  1. Go to the repository's settings.

  2. Click Milestones in the left hand navigation.

  3. Enter a version name.

  4. Press Add.

Version configuration

Versions are points in a project or product timeline. For example, in a software development project, a version could be a release number. Versions help you schedule and organize your projects and track where an issue had impact. Examples of versions:

  • 1.0

  • 1.1

  • 1.1.1

  • 1.1.2

  • v1.0

  • v1.1

To configure versions, do the following:

  1. Go to the repository's settings.

  2. Click Versions in the left hand navigation.

  3. Enter a version name.

  4. Press Add.

Additional Help