---
metadata:
  - property: og:type
    content: article
  - property: article:section
    content: Integrations with other services
  - property: og:title
    content: "Integration in the Yandex\_Tracker interface"
  - property: article:tag
    content: Instructions
  - name: generator
    content: Diplodoc Platform v5.66.1
alternate:
  - https://yandex.ru/support/tracker/en/user/forms-template.md
  - https://yandex.ru/support/tracker/ru/user/forms-template.md
  - href: https://yandex.ru/support/tracker/en/user/forms-template.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/support/tracker/en/llms.txt?revision=r22057024
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/en/llms.txt?revision=r22057024


# Integration in the Yandex Tracker interface

Yandex Tracker has a built-in form builder integrated with the Yandex Forms service. With the builder, you can quickly create a form linked to your [queue](*queue). On the issue creation page, the user can select the desired form and fill it out — as a result, an issue will be created in the queue: [How to create an issue in Tracker](https://yandex.ru/support/tracker/en/user/create-ticket.md).

If the queue was created using the **Support** template, it already has a form integrated for receiving user requests.

<!-- source: en/_includes/forms.md -->
{% note warning "" %}

Managing the queue's forms requires the [**Queue management** access rights](https://yandex.ru/support/tracker/en/manager/queue-access.md#permissions).

You can add up to 20 forms to one queue.

{% endnote %}
<!-- endsource: en/_includes/forms.md -->

## Step 1. Go to the form builder {#start}

1. <!-- source: en/_includes/transition-page.md -->
   In the left-hand panel, click ![](../_assets/svg/queues-ni.svg) **Queues** and select a queue. {#queue}
   <!-- endsource: en/_includes/transition-page.md -->

1. <!-- source: en/_includes/transition-page.md -->
   In the top right corner of the queue page, click ![](../_assets/svg/settings.svg)</svg> **Queue settings**. {#settings}
   <!-- endsource: en/_includes/transition-page.md -->

1. Go to **Integrations** → **Forms**. If the queue already has linked forms, click **Go to form list**.

1. Click **Add form** → ![](../_assets/svg/add-icon.svg)</svg> **Create new**.

   {% note tip "" %}

   You can also add a new form on the issue creation page. To do this, select the queue in the field at the top of the page and click **Create form**. [How to create an issue](https://yandex.ru/support/tracker/en/user/create-ticket.md)

   {% endnote %}

    ![Раздел «Формы» в настройках интеграций очереди с меню добавления формы](../_assets/forms/forms-queue-settings.png =700x){.border-yes}

1. Enter a name and description for the form and click **Next**.

## Step 2. Add fields to the form {#fields}

* To add the first question, select a question type from the suggested ones in the form creation area. To view the full list of types, click **All questions**.

* To add another question to the page, click **Add question** or hover over the created question and click the ![](../_assets/svg/add-icon.svg)</svg> icon. A new question will appear above the current one if you hover over the top part of the block.

* To copy or delete a question, click ![](../_assets/svg/icon-copy.svg)</svg> or ![](../_assets/svg/delete.svg)</svg>.

* To add an illustration to the question text or answer option, click the ![](../_assets/svg/icon-picture.svg)</svg> icon.

* To split the form into multiple pages, click the **Add page** button below the form creation area.

{% note tip "" %}

The built-in form builder supports only basic question types and integration settings. You can change the form's appearance, add additional questions, and configure their display logic in the full version of the builder in Yandex Forms: [Yandex Forms Help](https://yandex.com/support/forms).

To go to the Yandex Forms service, open the form and click the **Full version of Yandex Forms** button at the bottom of the page.

{% endnote %}

## Step 3. Configure issue creation {#integration}

1. Open the **Integrations** tab and select **Forms**.

1. In the **Perform actions** section, specify **always**.
If you need to configure conditions under which an issue will be created, select **on condition**. Then select a question and specify the answer upon receiving which an issue will be created in Tracker.

1. Specify the [queue](*queue) in which the issue will be created. To configure a [link](https://yandex.ru/support/tracker/en/user/ticket-links.md) <q>Parent issue — Sub-issue</q> for the created issue, select the **Convert to sub-issue** option and enter the [key](*issuekey) of the parent issue.

1. Select the **Issue type** and **Priority** of the issue. Available issue types depend on the queue settings: [Issue types in the queue](https://yandex.ru/support/tracker/en/manager/add-ticket-type.md).

1. Enter the issue name in the **Summary** field and the issue description in the **Description** field. Use [YFM markup](https://yandex.ru/support/tracker/en/user/markup.md) to format text.

1. To assign the default reporter and assignee, enter user logins without the `@` symbol. If no reporter is specified, the user who filled out the form will be assigned as the reporter by default.

1. To add an issue field that isn't available in the list of issue parameters, select **Add issue parameter** and start typing its name, then select the desired parameter from the suggested options.

1. If you want to save an answer to a certain form question in your issue parameters, select an issue field, click ![](../_assets/svg/add-icon.svg)</svg>, then click **Answer** and select the question.

    ![Mapping a form question response to the issue summary](../_assets/forms/forms-answer-mapping.png =511x){.border-yes}

   For more information about variables, see [Yandex Forms Help](https://yandex.com/support/forms/vars.html).

1. To pass attachments from the form to the issue, in the **Attach files from question responses** field, select a question of the <q>File</q> type.

1. To display a link to the created issue, enable the **Show the action result message to the user** option.

1. You can also configure integrations with other services for collaboration:

    * [Send a notification by email](https://yandex.com/support/forms/send-mail.html).
    * [Add the user's response to Wiki](https://yandex.com/support/forms/send-wiki.html).

    * [Send an HTTP request](https://yandex.com/support/forms/send-request.html).

1. Click **Publish**.

The created form will appear on the issue creation page: [How to create an issue in Tracker](https://yandex.ru/support/tracker/en/user/create-ticket.md).

You can manage forms for creating issues on the queue settings page: [Managing forms in a queue](https://yandex.ru/support/tracker/en/manager/manage-forms.md).

#### Learn more: {#see-also}

* [How to set up Yandex Tracker integration with Yandex Forms](https://yandex.ru/support/tracker/en/manager/about-forms-integration.md)
* [How to create a form in Yandex Forms](https://yandex.ru/support/tracker/en/manager/forms-integration.md)
* [Managing forms in a queue](https://yandex.ru/support/tracker/en/manager/manage-forms.md)
* [Yandex Forms Help](https://yandex.com/support/forms)

[*issuekey]: An issue key is a unique identifier contained in the issue link. It consists of the queue key and a number, for example `TEST-123`.

[*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.

