---
metadata:
  - name: generator
    content: Diplodoc Platform v5.47.3
alternate:
  - https://yandex.com.tr/support/tracker/en/manager/create-project.md
title: Managing projects in Yandex Tracker
description: In this tutorial, you will learn how to manage projects in Yandex Tracker.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/tracker/en/llms.txt


# How to create a project and add issues

In this section, you will learn how to manage your projects:

* [Creating a project](#create-project)
* [Adding issues to a project](#add-tickets)
* [Deleting a project](#delete)

## Creating a project {#create-project}

You can create a completely new project or base it on an issue.

### New project {#new-project}

To create a project:

1. Go to any page a project can be created from:

   * In the left panel, select <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" fill="currentColor" aria-hidden="true" class="yc-icon nv-composite-bar__menu-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="m8.879 4-.44-.44-.767-.767a1 1 0 0 0-.708-.293H6A1.5 1.5 0 0 0 4.5 4v5A1.5 1.5 0 0 0 6 10.5h7A1.5 1.5 0 0 0 14.5 9V5.5A1.5 1.5 0 0 0 13 4H8.879ZM6 1a3 3 0 0 0-3 3 3 3 0 0 0-3 3v5a3 3 0 0 0 3 3h7a3 3 0 0 0 3-3 3 3 0 0 0 3-3V5.5a3 3 0 0 0-3-3H9.5l-.768-.768A2.5 2.5 0 0 0 6.964 1H6ZM1.5 7A1.5 1.5 0 0 1 3 5.5V9a3 3 0 0 0 3 3h5.5a1.5 1.5 0 0 1-1.5 1.5H3A1.5 1.5 0 0 1 1.5 12V7Zm10.75 0a.75.75 0 0 0 0-1.5h-5.5a.75.75 0 0 0 0 1.5h5.5Z" clip-rule="evenodd"/></svg></svg> **Projects**, then click **Create** → **Project**.
   * In the [list of portfolios and projects](https://yandex.com.tr/support/tracker/en/manager/my-projects.md), on the **List** tab, click **Create project** under the list.

1. Enter a name for the project. It's better to keep it short and clear, which makes the project easier to work with.

1. On the **About the project** tab, add information:

   * **Project description**: What you are working on and what goals you want to achieve.
   * <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" aria-hidden="true" class="yc-icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path d="M67.508 468.467c-58.005-58.013-58.016-151.92 0-209.943l225.011-225.04c44.643-44.645 117.279-44.645 161.92 0 44.743 44.749 44.753 117.186 0 161.944l-189.465 189.49c-31.41 31.413-82.518 31.412-113.926.001-31.479-31.482-31.49-82.453 0-113.944L311.51 110.491c4.687-4.687 12.286-4.687 16.972 0l16.967 16.971c4.685 4.686 4.685 12.283 0 16.969L184.983 304.917c-12.724 12.724-12.73 33.328 0 46.058 12.696 12.697 33.356 12.699 46.054-.001l189.465-189.489c25.987-25.989 25.994-68.06.001-94.056-25.931-25.934-68.119-25.932-94.049 0l-225.01 225.039c-39.249 39.252-39.258 102.795-.001 142.057 39.285 39.29 102.885 39.287 142.162-.028A739446.174 739446.174 0 0 1 439.497 238.49c4.686-4.687 12.282-4.684 16.969.004l16.967 16.971c4.685 4.686 4.689 12.279.004 16.965a755654.128 755654.128 0 0 0-195.881 195.996c-58.034 58.092-152.004 58.093-210.048.041z"/></svg></svg> **File**: Add the project files.
   * <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="16" height="16" class="g-icon" fill="currentColor" stroke="none" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16"><g clip-path="url(#svg-im0r79zb__a)"><path fill="currentColor" fill-rule="evenodd" d="M10.257 4.2a.858.858 0 0 1-.86.274l-3.103-.776a2.81 2.81 0 0 0-2.796.876L1.242 7.152A3 3 0 0 0 .5 9.127V12a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2V3.309a1.933 1.933 0 0 0-3.4-1.258l-1.31 1.528-.533.622ZM14 6.48V3.31a.433.433 0 0 0-.762-.282l-1.842 2.15a2.358 2.358 0 0 1-2.362.753L5.93 5.154a1.31 1.31 0 0 0-1.303.408L2.37 8.139a1.5 1.5 0 0 0-.37.988v.685l2.304-1.44a2.59 2.59 0 0 1 2.458-.155l1.923.888a1.578 1.578 0 0 0 1.777-.317l.22-.22 1.575-1.574A1.862 1.862 0 0 1 14 6.479ZM2 12c0 .277.226.501.5.501h11a.5.5 0 0 0 .5-.5V8.337a.4.4 0 0 0-.683-.283L11.523 9.85a3.078 3.078 0 0 1-3.466.618L6.134 9.58a1.09 1.09 0 0 0-1.035.066L2.352 11.36a.752.752 0 0 0-.352.637Z" clip-rule="evenodd"/></g><defs><clipPath id="svg-im0r79zb__a"><path fill="currentColor" d="M0 0h16v16H0z"/></clipPath></defs></svg></svg> **Metric**: If you have a DataLens chart that tracks key project metrics, embed it on the project page. For more information about adding a metric, see [this](#add-metrics) guide.
   * <svg xmlns="http://www.w3.org/2000/svg" width="10" height="10" fill="currentColor" aria-hidden="true" class="yc-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 14 14"><path fill="currentColor" fill-rule="evenodd" d="M7.873 13.125a.875.875 0 1 1-1.75 0V7.87H.875a.875.875 0 0 1 0-1.75h5.248V.874a.875.875 0 1 1 1.75 0V6.12h5.249a.875.875 0 0 1 0 1.751H7.873v5.255z" clip-rule="evenodd"/></svg></svg> **Link**: Add links to other projects, portfolios, or goals.
   * <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="16" height="16" class="g-icon" fill="currentColor" stroke="none" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16"><g fill="currentColor"><path d="m8 9.076.085-.107a.751.751 0 1 0-1.171-.937L5.438 9.877 5.03 9.47a.747.747 0 0 0-1.06 0 .75.75 0 0 0 0 1.06l.407.408.593.592a.75.75 0 0 0 1.116-.061l.522-.654h.001L8 9.074Z"/><path fill-rule="evenodd" d="M12 11a3 3 0 0 0 3-3V4a3 3 0 0 0-3-3H8a3 3 0 0 0-3 3v1H4a3 3 0 0 0-3 3v4a3 3 0 0 0 3 3h4a3 3 0 0 0 3-3v-1h1ZM4 6.5A1.5 1.5 0 0 0 2.5 8v4A1.5 1.5 0 0 0 4 13.5h4A1.5 1.5 0 0 0 9.5 12V8A1.498 1.498 0 0 0 8 6.5H4ZM13.5 4A1.5 1.5 0 0 0 12 2.5H8A1.5 1.5 0 0 0 6.5 4v1H8a3 3 0 0 1 3 3v1.5h1A1.498 1.498 0 0 0 13.5 8V4Z" clip-rule="evenodd"/></g></svg></svg> **Checklist**: Specify the project's key milestones or goals. You can work with a project checklist just like an issue checklist. For details, see [Creating a checklist](https://yandex.com.tr/support/tracker/en/user/checklist.md).

   * In the right panel, specify the project parameters.

     {% cut "Description of project parameters" %}

      * **Status**: Specify the current stage of the project.
      * **Start date** and **Deadline**.
      * **Lead**, **Customers**, **Followers**, and **Participants**: Start typing the name or login of the employee and select a relevant option from the list.
      * **Included in the portfolio**: Specify the [portfolio](https://yandex.com.tr/support/tracker/en/manager/portfolio.md) the project belongs to.
      * **Tags**: Add or select the tags that would make it easier to find the project you need.

      {% endcut %}

1. [Add](#add-tickets) issues to the project. You can add issues from the project page or the issue page, or by using [bulk editing](https://yandex.com.tr/support/tracker/en/manager/bulk-change.md).

   The project is not linked to any issue queue: that is why you can add issues to it from any queue that you have access to. Access to project issues depends on the [access settings](https://yandex.com.tr/support/tracker/en/user/queue.md) of the queue that the issue belongs to.

   {% note warning "" %}

   You can add no more than 2,000 issues to a project.

   {% endnote %}

By default, a new project is available to all organization employees. [How to restrict access to a project](https://yandex.com.tr/support/tracker/en/manager/project-access.md)

### Copying a project {#copy-project}

To create a new project based on an existing one, use the copy option.

1. Open the project you want to copy.

1. In the top right corner, select <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" aria-hidden="true" class="yc-icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M14 6.125a1.874 1.874 0 1 1 .001 3.749A1.874 1.874 0 0 1 14 6.125zm-5.906 0a1.874 1.874 0 1 1 0 3.749 1.874 1.874 0 0 1 0-3.749zM2 6.125a1.874 1.874 0 1 1 .001 3.749A1.874 1.874 0 0 1 2 6.125z"/></svg></svg> **Actions** → <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="16" height="16" class="g-icon" fill="currentColor" stroke="none" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M12 2.5H8A1.5 1.5 0 0 0 6.5 4v1H8a3 3 0 0 1 3 3v1.5h1A1.5 1.5 0 0 0 13.5 8V4A1.5 1.5 0 0 0 12 2.5ZM11 11h1a3 3 0 0 0 3-3V4a3 3 0 0 0-3-3H8a3 3 0 0 0-3 3v1H4a3 3 0 0 0-3 3v4a3 3 0 0 0 3 3h4a3 3 0 0 0 3-3v-1ZM4 6.5h4A1.5 1.5 0 0 1 9.5 8v4A1.5 1.5 0 0 1 8 13.5H4A1.5 1.5 0 0 1 2.5 12V8A1.5 1.5 0 0 1 4 6.5Z" clip-rule="evenodd"/></svg></svg> **Copy project**.

1. Configure the project copy options:
    - Specify who will have access to the copied project: **All employees** or **Members only**.
    - To copy the project's files and attachments, enable the **Copy files and attachments** option.
    - To copy the values of the project's main fields, enable the **Copy main field values** option.

1. If you selected the **Copy main field values** option, fill in the **Summary**, **Description**, **Deadline**, **Responsible**, **Participants** fields. By default, the field values will be copied from the source project.

1. Click **Create copy**.

### Converting an issue to a project {#convert-from-task}

The converted issue will be added to a project and the new project will show its parameters:
* Name, description, checklist.
* Start date and end date.
* Author, assignee, and followers.

Issue comments are converted to project comments and displayed in the **About the project** tab.

To create a project based on an issue:

1. Open the issue page. The issue should not belong to another project. To delete an issue from the project, clear the **Project** field on the right panel.

1. In the top right corner, select **Actions** → **Convert to project** and click **Convert**.

## Adding issues to a project {#add-tickets}

An issue may belong to multiple projects. You can have only one main project, and the others are considered additional. In additional projects, you can [work](https://yandex.com.tr/support/tracker/en/manager/project-list.md) with the issue just like in the main project: it will appear in the issue list and on the Gantt chart.

When you filter issues by the **Project** parameter on other Yandex Tracker pages (for example, in widget settings, on a queue page, or in an issue filter), issues will be filtered only by their main project. To filter issues by all projects they belong to, enable the **Show issues for which this project is secondary** option when configuring the project filters. For more information about issue filters, see [Creating and configuring an issue filter](https://yandex.com.tr/support/tracker/en/user/create-filter.md).

{% note warning "" %}

You can add your issue to up to 40 projects, including the main one.

{% endnote %}

### From the project page {#from-project}

1. Go to the **Issues** tab and click <svg xmlns="http://www.w3.org/2000/svg" width="10" height="10" fill="currentColor" aria-hidden="true" class="yc-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 14 14"><path fill="currentColor" fill-rule="evenodd" d="M7.873 13.125a.875.875 0 1 1-1.75 0V7.87H.875a.875.875 0 0 1 0-1.75h5.248V.874a.875.875 0 1 1 1.75 0V6.12h5.249a.875.875 0 0 1 0 1.751H7.873v5.255z" clip-rule="evenodd"/></svg></svg> **Add issue**.

1. Select the issue you want to link:

    {% list tabs %}

    - New issue

      1. Click **New**.
      1. Enter the issue name, select the queue, and press **Enter**. The project will become the issue's main project.

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

      If you can create an issue in the queue [only using a form](https://yandex.com.tr/support/tracker/en/user/forms-template.md#new-task-page), you'll see the **Select form** button on the screen.

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

    - Existing issue

      1. Click **Existing**.
      1. Start typing the issue [key](*issuekey) or name and select the option you need from the list.

      <!-- source: en/_includes/projects.md -->
      If an issue already has a main project, the current project will become an additional project. If the issue is not added to other projects, this project will become its main.
      <!-- endsource: en/_includes/projects.md -->

   {% endlist %}

### From the issue page {#from-ticket}

1. Open the issue page.

1. Click the **Project** field on the right panel. If you don't see the **Project** field, add it by clicking **Add parameters**.

1. In the **Main** or **Additional** field, start typing the project name and pick the option you need from the list. Click **Save**.

### Adding multiple issues {#from-bulk}

1. Select the issues you need using [filters](https://yandex.com.tr/support/tracker/en/user/create-filter.md).

1. Select the issues that you want to add to the project.

1. In the bottom panel, click <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" aria-hidden="true" class="yc-icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M14 6.125a1.874 1.874 0 1 1 .001 3.749A1.874 1.874 0 0 1 14 6.125zm-5.906 0a1.874 1.874 0 1 1 0 3.749 1.874 1.874 0 0 1 0-3.749zM2 6.125a1.874 1.874 0 1 1 .001 3.749A1.874 1.874 0 0 1 2 6.125z"/></svg></svg>, then select **Add to project**.

1. Start typing a project name and select the option you need from the list.

1. Wait for the issues to be processed.

<!-- source: en/_includes/projects.md -->
If an issue already has a main project, the current project will become an additional project. If the issue is not added to other projects, this project will become its main.
<!-- endsource: en/_includes/projects.md -->

### Moving issues to another project {#update-project}

You can change the main project for all or some project issues. Child issues will also be added to the new main project.

1. Open the project page.

1. Go to the **Issues** tab.

1. Add <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="yc-checkbox__icon-svg yc-checkbox__icon-svg_type_tick" viewBox="0 0 12 10"><path d="m.49 5.385 1.644-1.644 4.385 4.385L4.874 9.77.49 5.385zm4.384 1.096L10.356 1 12 2.644 6.519 8.126 4.874 6.48v.001z"/></svg> next to the issues for which you want to change the main project.

   To select all the project issues at once, check the box <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="yc-checkbox__icon-svg yc-checkbox__icon-svg_type_tick" viewBox="0 0 12 10"><path d="m.49 5.385 1.644-1.644 4.385 4.385L4.874 9.77.49 5.385zm4.384 1.096L10.356 1 12 2.644 6.519 8.126 4.874 6.48v.001z"/></svg> above the issue list.

1. Click <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" aria-hidden="true" class="yc-icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M14 6.125a1.874 1.874 0 1 1 .001 3.749A1.874 1.874 0 0 1 14 6.125zm-5.906 0a1.874 1.874 0 1 1 0 3.749 1.874 1.874 0 0 1 0-3.749zM2 6.125a1.874 1.874 0 1 1 .001 3.749A1.874 1.874 0 0 1 2 6.125z"/></svg></svg> under the issue list and select **Change primary project**.

1. Start typing a project name and select the option you need from the list.

1. Wait for the issues to be processed.

## Deleting a project {#delete}

{% note alert "" %}

A project can be deleted by its author or the user specified in the **Responsible** field.

{% endnote %}

To delete a project:

1. In the left panel, select <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" fill="currentColor" aria-hidden="true" class="yc-icon nv-composite-bar__menu-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="m8.879 4-.44-.44-.767-.767a1 1 0 0 0-.708-.293H6A1.5 1.5 0 0 0 4.5 4v5A1.5 1.5 0 0 0 6 10.5h7A1.5 1.5 0 0 0 14.5 9V5.5A1.5 1.5 0 0 0 13 4H8.879ZM6 1a3 3 0 0 0-3 3 3 3 0 0 0-3 3v5a3 3 0 0 0 3 3h7a3 3 0 0 0 3-3 3 3 0 0 0 3-3V5.5a3 3 0 0 0-3-3H9.5l-.768-.768A2.5 2.5 0 0 0 6.964 1H6ZM1.5 7A1.5 1.5 0 0 1 3 5.5V9a3 3 0 0 0 3 3h5.5a1.5 1.5 0 0 1-1.5 1.5H3A1.5 1.5 0 0 1 1.5 12V7Zm10.75 0a.75.75 0 0 0 0-1.5h-5.5a.75.75 0 0 0 0 1.5h5.5Z" clip-rule="evenodd"/></svg></svg> **Projects** or follow the link [https://tracker.yandex.com/pages/projects/list <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="16" height="16" class="g-icon" fill="currentColor" stroke="none" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M10 1.5A.75.75 0 0 0 10 3h1.94L6.97 7.97a.75.75 0 0 0 1.06 1.06L13 4.06V6a.75.75 0 0 0 1.5 0V2.25a.75.75 0 0 0-.75-.75H10ZM7.5 3.25a.75.75 0 0 0-.75-.75H4.5a3 3 0 0 0-3 3v6a3 3 0 0 0 3 3h6a3 3 0 0 0 3-3V9.25a.75.75 0 0 0-1.5 0v2.25a1.5 1.5 0 0 1-1.5 1.5h-6A1.5 1.5 0 0 1 3 11.5v-6A1.5 1.5 0 0 1 4.5 4h2.25a.75.75 0 0 0 .75-.75Z" clip-rule="evenodd"/></svg></svg>](https://tracker.yandex.com/pages/projects/list) and open the project page.

1. In the top right corner of the page, click <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" aria-hidden="true" class="yc-icon"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M14 6.125a1.874 1.874 0 1 1 .001 3.749A1.874 1.874 0 0 1 14 6.125zm-5.906 0a1.874 1.874 0 1 1 0 3.749 1.874 1.874 0 0 1 0-3.749zM2 6.125a1.874 1.874 0 1 1 .001 3.749A1.874 1.874 0 0 1 2 6.125z"/></svg></svg> and select **Delete project**.

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