How to create an issue in Tracker

You can create issues in any of the available queues. Select the queue so that its subject corresponds to the issue's subject. If you do not know which queue to create your issue in, check with the project manager or your company's admin.

Each new issue is automatically assigned a key, which is a unique code that helps you easily find the issue. The issue key consists of the queue key and the issue number (for example, TEST-123). You'll find the key above the issue's title on the issue page.

You can use the key to navigate to the issue page via a link (for example, https://tracker.yandex.com/TEST-123) or reference that issue by pasting its key in a comment or in the description of another issue.

There are several ways to create a new issue:

  1. In the left panel, click Create issue.

  2. At the top left, select the queue where you want to create the issue.
    If forms for creating issues are set up in the queue, select No form.

  3. Enter the issue summary. Try to make the summary short and convey the meaning of the work.
    For example: “Create a quarterly results presentation”.

  4. Add an issue description: write what result you expect to get, list the details that will help the assignee complete the work correctly.
    For example, you can write which presentation template is best to use or which colleagues to get fresh data from.


    You can use YFM markup to format the description.

  5. To add files or images to the issue, click File under the description.

  6. To add a list of steps for resolving the issue, click Checklist under the description.

  7. If the issue needs to be completed by a certain date, in the right panel, specify the date in the Deadline field.

  8. If you know who will complete your issue, in the right panel, enter the employee's name in the Assignee field. To add your name to the field, click Me. By default, the assignee will receive a notification about the new issue by email.

    If you change the assignee, the previous user will be added to the issue's follower list.

  9. If there are users who want to stay up to date on the issue progress, add them to the Followers field. They will receive notifications about changes to the issue.

    If a user writes a comment on the issue, they will automatically be added to the follower list. If you invite a user to the issue, they will receive a notification and can find it in their issue list using the "Needs response" filter.

  10. To add another issue field to the right panel that is not currently displayed, at the bottom of the panel click Edit parameter list and start typing its name, for example "Story Points".


    You can also specify other issue parameters, such as Type, Priority, or Project. You can leave the default values and edit them later.

  11. Click Create issue. The page of your new issue will open.

If you frequently add the same values to issue fields, such as tags, create issues using a template (Creating a template) or a form (How to set up Yandex Tracker integration with Yandex Forms).

A form can be linked to a queue by its owner or a user with the "Queue settings" access type.

  1. In the left panel, click Create issue.

  2. At the top left, select the queue where you want to create the issue.

  3. If the selected queue uses forms to create issues, select the appropriate form and fill it in.

    If you are unsure how to fill in the form correctly, contact the queue owner.

When no forms are linked to the queue, the standard page opens when creating an issue, as in the "Standard method" option.

You can place a form link on a wiki page or your website. This lets users create issues in the queue even if they do not have access to Tracker. For example, you can use forms for contacting support or submitting service requests: Accepting requests by email and via forms.

Any user can create an issue template; by default, it is only available to the author. To let your colleagues use the template, add users or groups in the access settings:

  1. In the left panel, click Create issue.

  2. At the top left, select the queue where you want to create the issue.
    If forms for creating issues are set up in the queue, select No form.

  3. In the upper-right corner of the page, click Apply template.

  4. Select the appropriate template or click Manage templates to create a new one.

    You can edit the fields of issues created from a template.

May come in handy

A queue key is a unique code for a queue consisting of Latin characters, for example TEST. The key is contained in the link to the queue and its issues, and you need to specify it in API requests and auto action settings. You can't change the key after creating the queue.

A queue is a space for issues related to a single process, product, team, or department. A queue helps you store issues in one place and manage work according to common rules.

A form is a page with questions and fields for entering data. In Tracker, you can use a form as a template for creating issues.