How to create an issue

You can create issues in any of the available queues. Select the queue that best matches the topic of the issue. If you don't know which queue to create the issue in, check with the project manager or your organization's admin.

Create an issue

To create an issue:

  1. Click New issue on the upper panel in Tracker.

  2. Select the Queue to create the issue in.

  3. Choose the Type for the issue.

    Each queue can have its own set of issue types. If you don't see an appropriate type in the list, contact the queue owner.

  4. Enter a title in Summary.

  5. Fill in the Description. To format the text, use wiki markup.

  6. Click Choose files to attach files or images to the issue.

    To insert images into the text, click .

  7. Enter the login or name of the assignee, or click Me to assign the issue to yourself.

    You can also leave this field empty to assign someone later.

  8. Set the Priority.

  9. If your issue is related to other issues, list them in Links.

  10. If necessary, make additional settings. To do this, add fields using the button and fill them in.

    Advanced settings
    FieldDescription
    System

    Followers

    Logins or names of users subscribed to the issue.

    By default, followers have access to read and edit the issue and are notified of any changes to it.

    Access rules depend on the queue settings. Check with the queue owner.

    Access

    By default, users in this group have access to read and edit the issue, but they do not receive notifications of changes to the issue.

    Access rules depend on the queue settings. Check with the queue owner.

    Maillists

    Teams and departments that are subscribed to the issue.

    By default, members of these teams have access to read and edit the issue and receive notifications of changes.

    Access rules depend on the queue settings. Check with the queue owner.

    Start date

    Date when progress started on the issue. You usually don't need to fill this in when creating a task.

    End date

    Date when the issue was completed. You usually don't need to fill this in when creating a task.

    Deadline

    Date by which the issue should be resolved.

    Tags

    Tags are text labels that make it easier to find and sort issues.

    Components

    You can mark issues with special labels called components. Use them to sort issues within a queue.

    The list of available components is defined in the queue settings.

    Affected version

    The version of the product that the issue is related to. The list of available versions is defined in the queue settings.

    The Affected version field is typically used with the Bug type of issue.

    Fix version

    The version of the product that the issue is related to. The list of available versions is defined in the queue settings.

    The Affected version field is typically used with the Bug type of issue.

    Time tracking

    Original estimate

    Initial estimation of time needed for the issue. Time is specified in the format 1w2d3h.

    Agile

    Sprint

    The name of the sprint that the issue belongs to.

    Story Points

    Estimated effort for the issue in terms of Story Points.

    The most popular issue settings are available in Tracker by default. If you don't see the settings you need, your company's admin can create them for you.

  11. Click Create at the bottom of the page.

    Tip. If you need to create a lot of similar issues, make a template for them.

Each new issue is assigned a unique key that identifies it. The issue key is shown under the title and consists of the queue key and the issue number (for example, TEST-1234).

Create a sub-issue

Complex tasks can be divided into simpler sub-issues and tracked separately.

To create a sub-issue:

  1. Open the issue page to create a sub-issue for.

  2. Choose Actions → Create sub-issue.

  3. Fill in the fields the same way as when creating a new task.

  4. Click Create.