---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.3
  - property: og:type
    content: article
  - property: article:section
    content: Без рубрики
  - property: og:title
    content: Ограничения и допустимые значения в Яндекс Трекере
  - property: article:tag
    content: Сборник инструкций
alternate:
  - https://yandex.ru/support/tracker/en/validation.md
  - https://yandex.ru/support/tracker/ru/validation.md
  - href: ru/validation.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt


# Ограничения и допустимые значения в Трекере

На странице перечислены доступные пользователям поля и объекты, для которых в Трекер действуют ограничения на формат, размер и количество значений. Кроме перечисленных правил, значение каждого поля должно соответствовать его типу. Другие проверки логической согласованности данных здесь не описаны.

## Вложения {#attachments}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный. Не более 2 000 символов. |
| `size` | `long` | Размер не должен быть равен нулю. Максимальный объем вложения (для каждого файла) — 128 МБ в интерфейсе Трекера и через API. |

## Доски {#boards}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный, непустой. Не более 2 000 символов. |
| `columns` | `ListF<BoardColumn>` | Все колонки должны быть уникальными. |
| `queues` | `ListF<QueueRef>` | Не более 20 очередей. |
| `backlogAvailable`, `sprintsAvailable` | `Option<Boolean>` | Бэклог и спринты должны быть включены или выключены одновременно. |

## Заметки на доске {#board-notes}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `text` | `String` | Обязательный. Не более 5 000 символов. |

## Комментарии {#comments}

В одной задаче может быть не более 1 000 комментариев.

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `text` | `Option<String>` | Не более 512 000 символов. Пустой текст разрешен, только если в комментарии упомянуты пользователи (`summonees`). |
| `replyTo` | `ListF<ObjectId>` | Не более 50 цитируемых комментариев. |

## Шаблоны комментариев {#comment-templates}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный, непустой. Не более 10 000 символов. |
| `description` | `Option<String>` | Не более 10 000 символов. |
| `template` | `Option<String>` | Если параметр задан, его значение не должно быть пустым. |

## Компоненты {#components}

В одной очереди может быть не более 10 000 компонентов.

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `queue` | `QueueRef` | Обязательная ссылка на очередь. |
| `name` | `String` | Непустой. Не более 512 символов. |
| `description` | `Option<String>` | Не более 2 000 символов. |

## Глобальные поля {#custom-db-fields}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `id` | `String` | Не более 30 символов. |
| `type` | `DbFilterableFieldType<T, ?>` | Тип поля обязателен. |
| `category` | `FieldCategoryRef` | Категория поля обязательна. |
| `name` | `LocalizedString` | Не более 50 символов для каждого языка. |
| `description` | `Option<String>` | Не более 300 символов. |

## Дашборды {#dashboards}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный. Не более 10 000 символов. |

## Категории полей {#field-categories}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `LocalizedString` | Обязательный, непустой. Не более 2 000 символов. |
| `order` | `int` | Обязательный. |

## Отсутствия сотрудников {#absences}

Создавать отсутствия могут только сотрудники поддержки, а в B2B — администраторы организации.

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `id` | `String` | Не более 128 символов. |

## Задачи {#issues}

Рекомендуется добавлять в одну задачу не более 300 наблюдателей. При большем количестве страница задачи может загружаться с задержкой.

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `queue` | `QueueRef` | Обязательная ссылка на очередь. |
| `type` | `IssueTypeRef` | Обязательная ссылка на тип задачи. |
| `summary` | `String` | Непустой. Не более 32 766 символов. |
| `tags` | `ListF<String>` | Каждый тег должен быть непустым, не более 480 символов и не содержать запятых и пробелов. |
| `customFields` | `MapF<String, Object>` | Значения должны соответствовать типам полей. |
| `localFields` | `MapF<String, Object>` | Значения должны соответствовать типам полей. |
| `checklistItems` | `ListF<ChecklistItem>` | Текст каждого элемента — не более 2 000 символов. |

### Ограничения по типам полей {#field-types}

Ограничения применяются к системным, глобальным и локальным полям задач, а также к полям других объектов, для которых указана проверка по типу поля.

| Тип поля | Ограничение |
| --- | --- |
| Выпадающий список | Не более 3 000 значений. При выборе значения отображается не более 10 элементов. |
| `StringFieldType` | Не более 32 766 символов. Обязательное поле не должно быть пустым. |
| `IcuStringFieldType` | Те же ограничения, что у `StringFieldType`. |
| `MetaEntityStatusFieldType` | Те же ограничения, что у `StringFieldType`. |
| `TagsFieldType` | Непустое значение без запятых и пробелов. Не более 480 символов. |
| `EmailFieldType` | Значение должно соответствовать формату адреса электронной почты. |
| `WikiPageIdFieldType` | Идентификатор должен быть непустым. В списке может быть не более 100 страниц. |
| `UriFieldType` | Не более 32 766 символов. |
| `IntegerFieldType` | Целое число от −2 147 483 648 до 2 147 483 647. |
| `LongFieldType` | Значение типа `long`. |
| `FloatFieldType` | Конечное число: значения `NaN`, `+INF` и `−INF` запрещены. |
| `BooleanFieldType` | Логическое значение `Boolean` или `Number`, равное `0` или `1`. |
| `TimeTrackingDurationFieldType` | Период не должен содержать годы и месяцы. |
| `DateFieldType` | Дата от `0001-01-01` до `3000-01-01`. |
| `DateTimeFieldType` | Дата и время от `0001-01-01` до `3000-01-01`. |
| `QuarterFieldType` | Дата квартала от `0001-01-01` до `3000-01-01`. |
| `PaletteColorFieldType` | Ключ — не более 32 символов и должен соответствовать регулярному выражению `(\d\|\w\|-\|_)+`. |
| `UserToDoubleFieldType` | Пользователь должен существовать, `value` не должен быть равен `null`. |
| `ChecklistItemFieldType` | Текст — непустой, не более 2 000 символов; ссылка — не более 32 766 символов. |
| `MetricItemFieldType` | Текст — непустой, не более 2 000 символов; ссылка — не более 32 766 символов. |
| `KeyResultItemFieldType` | Текст — непустой, не более 2 000 символов. Для типа `VALUE` обязателен `progress`; в `progress` обязательны `start` и `end`. Числовые значения должны быть конечными. |
| `UserFieldType` | Пользователь должен существовать. |
| `IssueFieldType` | Задача должна существовать. |
| `QueueFieldType` | Очередь должна существовать. |
| `StatusFieldType` | Статус должен существовать. |
| `PriorityFieldType` | Приоритет должен существовать. |
| `ResolutionFieldType` | Резолюция должна существовать. |
| `IssueTypeFieldType` | Тип задачи должен существовать. |
| `ComponentFieldType` | Компонент должен существовать. |
| `VersionFieldType` | Версия должна существовать. |
| `SprintFieldType` | Спринт должен существовать. |
| `ProjectFieldType` | Проект должен существовать. |
| `BoardsFieldType` | Доска должна существовать. |
| `GroupFieldType` | Группа должна существовать. |
| `GoalsFieldType` | Цель должна существовать. |
| `ServiceFieldType` | Сервис должен существовать. |
| `IdpProductFieldType` | Продукт IDP должен существовать. |
| `OfficeFieldType` | Офис должен существовать. |
| `TranslationFieldType` | Перевод должен существовать. |
| `MailListFieldType` | Почтовая рассылка должна существовать. |
| `MetaEntityFieldType` | Все ссылки на метасущности должны быть корректными. |
| `SlaViolationStatusFieldType` | Значение должно входить в перечень значений перечисления. |
| `SlaClockStatusFieldType` | Значение должно входить в перечень значений перечисления. |
| `IssueRelationshipFieldType` | Значение должно входить в перечень значений перечисления. |

## Макросы {#issue-macros}

В одной очереди может быть не более 1 000 макросов.

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный. Не более 2 000 символов. |
| `body` | `Option<String>` | Не более 400 000 символов. Значение должно быть корректным шаблоном Mustache. |
| `description` | `Option<String>` | Не более 2 000 символов. |

## Шаблоны задач {#issue-templates}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный. Не более 10 000 символов. |
| `description` | `Option<String>` | Не более 32 766 символов. |
| `metricItems` | `ListF<MetricItem>` | Текст каждого элемента — не более 2 000 символов. |
| `checklistItems` | `ListF<ChecklistItem>` | Текст каждого элемента — не более 2 000 символов. |
| `fieldTemplates` | `MapF<String, Object>` | Значения должны соответствовать типам полей, как у задачи. |

## Типы задач {#issue-types}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `key` | `String` | Обязательный. Не более 30 символов. |
| `name` | `String` | Не более 50 символов. |
| `description` | `Option<String>` | Не более 300 символов. |

## Приоритеты {#priorities}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Не более 300 символов. |
| `description` | `Option<String>` | Не более 2 000 символов. |

## Очереди {#queues}

В одну очередь можно добавить не более 20 [форм](https://yandex.ru/support/tracker/ru/manager/about-forms-integration.md).

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `key` | `String` | Обязательный. От 2 до 15 латинских букв. Значение преобразуется в верхний регистр. |
| `name` | `String` | Обязательный. После удаления пробелов в начале и конце — от 2 до 40 символов. |
| `permissionDeniedMessage` | `Option<String>` | Не более 32 766 символов. |
| `wikiPageIds` | `ListF<String>` | Не более 100 идентификаторов. |

## Напоминания {#reminders}

Для одной задачи можно создать не более 100 напоминаний.

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `note` | `Option<String>` | Не более 140 символов. |
| `when` | `Instant` | Обязательный. Дата и время не должны быть раньше текущего момента. |

## Резолюции {#resolutions}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `key` | `String` | Обязательный. Не более 30 символов. |
| `name` | `String` | Не более 50 символов. |
| `description` | `Option<String>` | Не более 300 символов. |

## Спринты {#sprints}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный. Не более 2 000 символов. |
| `board` | `BoardRef` | Обязательная ссылка на доску. |
| `startDate` | `Instant` | Обязательный. Дата начала не должна быть позже даты окончания. |
| `endDate` | `Instant` | Обязательный. Дата окончания не должна быть раньше даты начала. |

## Статусы {#statuses}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `key` | `String` | Обязательный. Не более 30 символов. |
| `name` | `LocalizedString` | Обязательный для всех языков. Не более 50 символов для каждого языка. |
| `description` | `Option<String>` | Не более 300 символов. |

## Теги {#tags}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `id` | `String` | Непустой. Не более 480 символов. Запятые и пробелы запрещены. |

## Папки сохраненных фильтров {#saved-filter-folders}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Не более 255 символов. |

## Версии {#versions}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный. Не более 500 символов. |
| `description` | `Option<String>` | Обязательный. Не более 2 000 символов. |

## Учет времени {#worklog}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `comment` | `Option<String>` | Не более 32 766 символов. |

## Автодействия {#autoactions}

В одной очереди может быть не более 100 автодействий.

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Не более 2 000 символов. |
| `description` | `Option<String>` | Не более 2 000 символов. |

## Рабочие календари {#working-calendars}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `LocalizedString` | Обязательный. Не более 2 000 символов. |

## Метасущности {#meta-entities}

Метасущности — общий интерфейс для проектов, портфелей, целей, отчетов и новых объектов. К их полям применяются те же ограничения по типу, что и к полям задач.

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `systemFields` | `MapF<String, Object>` | Значения должны соответствовать типам полей. |
| `storageFields` | `MapF<String, Object>` | Значения должны соответствовать типам полей. |
| `customFields` | `MapF<String, Object>` | Значения должны соответствовать типам полей. |
| `localFields` | `MapF<String, Object>` | Значения должны соответствовать типам полей. |

## Локальные поля {#local-fields}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `key` | `String` | Не более 30 символов. |
| `name` | `LocalizedString` | Непустое значение для каждого заданного языка. Не более 50 символов. |
| `description` | `Option<String>` | Не более 300 символов. |

## Правила уведомлений {#notification-rules}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный. Не более 2 000 символов. |

## Покер планирования {#poker}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `issues` | `ListF<IssueRef>` | Не более 100 задач. |

## Регулярные действия {#regular-actions}

В одной очереди может быть не более 100 регулярных действий.

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Не более 2 000 символов. |
| `description` | `Option<String>` | Не более 2 000 символов. |
| `launchesConfig.start` | `Instant` | Дата начала не должна быть позже даты окончания. |
| `launchesConfig.end` | `Instant` | Дата окончания не должна быть раньше текущего момента или даты начала. |

## Правила SLA {#sla-settings}

В одной очереди может быть не более 30 правил SLA.

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный. Не более 2 000 символов. |
| `thresholds` | `ListF<SlaTimerThreshold>` | Обязательный. Длительность каждого порогового значения — от 1 минуты до 100 лет. |

## Триггеры {#triggers}

В одной очереди может быть не более 1 000 триггеров.

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный, непустой. Не более 2 000 символов. |
| `description` | `Option<String>` | Не более 2 000 символов. |
| `actions` | `ListF<DbTriggerAction>` | Не более 10 действий. Формула в действии — не более 1 000 символов. |

## Виджеты {#widgets}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `description` | `String` | Обязательный. Не более 32 766 символов. |

## Рабочие процессы {#workflows}

| Параметр | Тип | Ограничение |
| --- | --- | --- |
| `name` | `String` | Обязательный. Не более 2 000 символов. |