---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.3
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/tracker-integration.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/tracker-integration.md
  - href: en/sourcecraft/concepts/tracker-integration.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
title: Integrating SourceCraft with Yandex Tracker
description: After integrating SourceCraft with Yandex Tracker, you can link pull requests to trackable issues, display statuses, arrange automatic issue references, and search external issues.
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/en/llms.txt


# Integrating SourceCraft with Yandex Tracker

<!-- source: en/_includes/sourcecraft/tracker-integration-intro.md -->
[Yandex Tracker](https://yandex.ru/support/tracker/ru) is a task management and team collaboration service: you can manage tasks, projects, goals, and portfolios, set up processes, and collect your team's performance analytics.

SourceCraft offers integration with Tracker. It allows you to link [pull requests](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#pr) and SourceCraft [tasks](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#issues) with Tracker issues, follow the status and activity of linked pull requests and SourceCraft tasks in a Tracker issue, and find linked Tracker issues directly in the repository interface. The integration helps you sync the actions of SourceCraft developers with task management processes in Tracker, thus eliminating the need to switch between the services.
<!-- endsource: en/_includes/sourcecraft/tracker-integration-intro.md -->

## Linking pull requests and SourceCraft issues to Tracker issues {#link-pr}

In SourceCraft [pull requests](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#pr) and [issues](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#issues), you can link a Tracker issue via the **Related issues** → ![image](../../_assets/console-icons/file-text.svg) **External** section. When linked, the pull request or SourceCraft issue is automatically attached to the Tracker issue, enabling seamless navigation between services.

## Automatic links to Tracker issues {#auto-links}

<!-- source: en/_includes/sourcecraft/tracker-magic-links.md -->
If you add a link to a Tracker issue, e.g., `https://tracker.yandex.com/TEST-123`, to the description or comment of a SourceCraft pull request or issue, it will be converted to a hyperlink in [TEST-123](https://tracker.yandex.com/TEST-123) format. You can navigate to the issue directly from the SourceCraft UI without copying the link manually.

Note that mentioning a Tracker issue in the description or comment of a SourceCraft pull request or issue does not create a relation between them.
<!-- endsource: en/_includes/sourcecraft/tracker-magic-links.md -->

## Displaying linked SourceCraft pull requests and issues in Tracker {#tracker-view}

A Tracker issue linked to SourceCraft pull requests or issues gets an **External application links** section. For each linked entity, this section provides the following details:
* Repository slug
* Number, link, and title of the pull request or issue
* Current status
* Assignee

You can navigate directly from the Tracker issue to the linked SourceCraft pull request.

## List of external issues in the repository {#external-issues}

The SourceCraft repository's ![image](../../_assets/console-icons/calendar.svg) **Plan** → ![image](../../_assets/console-icons/list-check.svg) **External issues** section shows the full list of Tracker issues. For each issue in the list, it provides the following details:
* Its key and title
* Short description
* Issue status in Tracker
* Assignee

<!-- source: en/_includes/sourcecraft/tracker-integration-ticket-list-tip.md -->
{% note tip %}

You can search for tasks by title and description, filter by [queue](https://yandex.ru/support/tracker/ruqueue-intro), and sort by key.

{% endnote %}
<!-- endsource: en/_includes/sourcecraft/tracker-integration-ticket-list-tip.md -->

## Limits {#limits}

* Only one Tracker organization can be connected per SourceCraft [organization](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#org).

  To link a different Tracker organization, disable the current integration first. 
  
  <!-- source: en/_includes/sourcecraft/tracker-integration-former-connection.md -->
  The already created links of pull requests and SourceCraft tasks with Tracker issues will not be deleted.
  <!-- endsource: en/_includes/sourcecraft/tracker-integration-former-connection.md -->

  <!-- source: en/_includes/sourcecraft/tracker-integration-org-tip.md -->
  {% note tip %}

  We recommend you to use the same Yandex Cloud organization for Tracker that you work from in SourceCraft.

  {% endnote %}
  <!-- endsource: en/_includes/sourcecraft/tracker-integration-org-tip.md -->

* <!-- source: en/_includes/sourcecraft/tracker-integration-paid.md -->
  You can connect to SourceCraft only organizations of which you are the administrator and in which Tracker has been paid.
  <!-- endsource: en/_includes/sourcecraft/tracker-integration-paid.md -->
* <!-- source: en/_includes/sourcecraft/tracker-integration-sso.md -->
  If you are using Yandex Cloud [SAML-compatible identity federations](https://yandex.cloud/en/docs/organization/concepts/add-federation) to authorize corporate accounts in SourceCraft, you can only configure integration with Tracker in the Yandex Cloud organization you are using to work with SourceCraft.
  <!-- endsource: en/_includes/sourcecraft/tracker-integration-sso.md -->
* You can only link SourceCraft pull requests and issues to Tracker issues that you have access to in Tracker.

### Useful links {#see-also}

* [Setting up SourceCraft integration with Yandex Tracker](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/tracker-integration.md)
* [Webhooks in SourceCraft](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/webhooks.md)
* [Configuring a webhook in a SourceCraft repository](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/webhooks.md)
* [Yandex Tracker guides](https://yandex.ru/support/tracker/ru)
