Типы полей

Однострочный текст

Идеально подходит для коротких текстовых данных: названий, имен, артикулов или кратких подписей. Этот тип используется по умолчанию для первого (стартового) поля в любой новой таблице.

Длинный текст

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

Форматированный текст: в длинном тексте можно включить режим Markdown. Он подходит для страниц обновлений, статей, changelog, FAQ и других материалов, которые затем публикуются на сайте через Public API.

Как это работает:

• значение хранится как обычный текст в формате Markdown;
• в интерфейсе можно писать и предварительно смотреть Markdown;
• при чтении через GET Public API можно выбрать параметр rich_text:

markdown — вернуть исходный Markdown (по умолчанию);

html — вернуть безопасно форматированный HTML;

raw — вернуть plain text без Markdown/HTML-разметки.

Число

Универсальное поле для любых числовых значений (как целых, так и дробных). Используйте его для финансовых сумм, количества товаров, рейтингов, KPI и других метрик.

Чекбокс

Простое логическое поле (Да/Нет или true/false). Незаменимо для быстрых отметок статуса: задача выполнена, заказ оплачен, документ подтвержден.

Одиночный выбор

Позволяет выбрать ровно одно значение из заранее заданного списка вариантов.

• Каждому варианту можно назначить свой цвет для наглядности.
• Это поле является ключевым для работы с представлением Kanban, где каждый вариант становится отдельной колонкой.

Множественный выбор

Позволяет выбрать несколько значений из заранее заданного списка вариантов.

• Каждому варианту можно назначить свой цвет.
• В фильтрах оператор содержит ищет записи, где выбран хотя бы один указанный вариант.
• При группировке запись попадает в каждую группу выбранных вариантов.
• В CSV/XLSX значение экспортируется как JSON-массив строк, например ["Срочно","Бэклог"]; в JSON-экспорте и Public API значение остаётся массивом.

Дата

Поле для хранения календарной даты без указания времени. Вы можете гибко настроить формат отображения (например, ДД.ММ.ГГГГ или ММ/ДД/ГГГГ).

Время

Хранит только время суток. Поддерживает различные пользовательские шаблоны отображения (12-часовой или 24-часовой формат).

Дата и время

Комбинированный тип, фиксирующий точный момент времени. Обязателен для использования в представлении Calendar, если вам нужна почасовая сетка расписания на день.

URL

Специальное поле для веб-ссылок. В интерфейсе таблицы значение автоматически превращается в кликабельную ссылку для быстрого перехода.

Email

Поле для адресов электронной почты со встроенной проверкой (валидацией) правильности формата.

Пользователь

Позволяет привязать запись к конкретному участнику вашей организации.

Идеально подходит для назначения ответственных за задачи, указания авторов документов или владельцев проектов.

Файл

Универсальное хранилище для любых типов файлов (документы, изображения, видео, архивы).

• Возможности: загрузка, переименование, удаление, скачивание и копирование постоянных ссылок для шеринга, когда эта опция включена для файлов.
• Для изображений и видео: доступен удобный предпросмотр прямо в таблице и полноэкранный просмотр.
• Ограничения: один файл может быть размером до 5 ГБ, а общий объем файлов и активных загрузок ограничен лимитом хранилища вашей организации.

Связь с записью

Мощный инструмент для построения реляционных баз данных. Позволяет связать текущую запись с одной или несколькими записями из другой таблицы (в рамках одной базы данных).

Длительность

Специализированное поле для учета затраченного времени. Поддерживает удобное форматирование и ведение журнала времени. Отлично подходит для тайм-трекинга по задачам.

JSON

Поле для хранения структурированных данных в формате JSON: настроек интеграции, ответа внешнего сервиса, набора параметров или небольшого массива.

В интерфейсе редактирование происходит через встроенный JSON-редактор с подсветкой синтаксиса. При работе через Public API данные передаются и принимаются как стандартный JSON-объект.

Какой JSON подходит: компактный объект или массив, который удобно открыть и прочитать в карточке записи. Например: { "source": "crm", "score": 91, "tags": ["vip", "new"] }.

Что лучше не хранить в JSON-поле: большие логи, полные документы, огромные ответы API, тысячи ключей, очень глубокие вложения и массивы на тысячи элементов. Такие данные лучше разбить на несколько записей, оставить только нужные поля или прикрепить исходный документ файлом.

Если JSON не сохраняется, обычно причина одна из трёх: значение слишком большое, внутри есть слишком длинная строка или структура слишком сложная для отображения и проверки.