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.