# Переменные: как добавить поле для заполнения

> Что такое переменная, как найти её в каталоге, вставить в текст шаблона, поставить в несколько мест и что умеет меню «⋯» у метки.

Статья базы знаний DataDoc, раздел «Шаблоны: создание и редактирование → Поля и стороны». Страница: https://datadoc.ru/ru/knowlege/u-tpl-peremennye/. Обновлено: 2026-11-07. Автор: DataDoc.RU - документы и подписание.
Карта всей базы знаний: https://datadoc.ru/ru/knowlege/llms.txt

Переменная это место в тексте шаблона, которое при создании документа заполняется по-новому: фамилия, дата, сумма, адрес. В шаблоне она видна как цветная метка, а в готовом документе на её месте стоит то, что ввёл человек.

## Что вам понадобится

- Шаблон, открытый в редакторе: **«Шаблоны»**, затем **«Создать шаблон»** или «⋯» → **«Редактировать»** у готового шаблона.

## Этап 1. Найдите переменную в каталоге

1. Поставьте курсор в тексте туда, где должно стоять значение, например после слов «Заказчик: ».
2. Справа, в блоке стороны (по умолчанию «Сторона 1»), нажмите **«Добавить переменную»**. Число рядом показывает, сколько разных переменных уже добавлено в сторону.

![Блок стороны справа: строка «Добавить переменную» и метка переменной в тексте](https://api.forma.today/api/v1/knowledgepublic/files/023a9e1c371068103ce0b61c01000610.png)

_Блок стороны справа: строка «Добавить переменную» и метка переменной в тексте_

3. В окне **«Добавить переменную»** начните вводить название в строку поиска, например «Фамил». Справа от каждой найденной переменной серым указана её группа, например «Паспорт РФ».

![Поиск в окне «Добавить переменную»](https://api.forma.today/api/v1/knowledgepublic/files/917d0aa062bc6ea14212d6d572c7d0ce.png)

_Поиск в окне «Добавить переменную»_

4. Поставьте галочку у нужной переменной. Она сразу попадает в блок стороны.
5. Закройте окно крестиком или клавишей Esc.

> **Совет.** **Совет.** названия повторяются. Например, «Номер» есть у паспорта, водительского удостоверения и военного билета. Смотрите на серую подпись группы и выбирайте нужную.

## Как устроен каталог

Если удобнее искать по смыслу, раскройте разделы. Их четыре:

- **«Физические лица»**: паспорт РФ, водительское удостоверение, загранпаспорт, недвижимость, аренда и другое.
- **«Юридические лица»**: реквизиты организации (группа «Юридические лица и ИП»: название, ИНН, ОГРН, адрес, руководитель), а также группы по отраслям.
- **«ИП»**: данные индивидуального предпринимателя.
- **«Общие переменные»**: контактные данные, банковские реквизиты, договоры, оплаты, пени и штрафы, работы и услуги.

![Окно «Добавить переменную»: четыре раздела](https://api.forma.today/api/v1/knowledgepublic/files/807e6cd00357991b52ddd309e4c35704.png)

_Окно «Добавить переменную»: четыре раздела_
Внутри раздела группы раскрываются, переменные показаны плитками. Уже выбранные отмечены синей галочкой. Ссылка **«Как добавлять переменные?»** вверху окна открывает короткое видео.

![Группа «Паспорт РФ» раскрыта: переменные с галочками](https://api.forma.today/api/v1/knowledgepublic/files/8f199af4cc8fffe4f6ed285d2d586cfc.png)

_Группа «Паспорт РФ» раскрыта: переменные с галочками_
Готовые переменные DataDoc уже настроены: у них есть тип, подсказка внутри поля и проверка значения. Их данные подставляются из карточек контрагентов. Нужного поля нет: [создайте свою переменную](https://datadoc.ru/ru/knowlege/u-tpl-svoya-peremennaya/llms.txt).

### Какие группы есть в разделах

- **«Физические лица»**: «Паспорт РФ», «Водительское удостоверение», «Военный билет», «Загранпаспорт РФ», «Иные документы и реквизиты», «Транспортное средство», «Займы», «Недвижимость», «Аренда», «Иностранный гражданин».
- **«Юридические лица»**: «Юридические лица и ИП», «Трудовые отношения», «Судебные дела», «Транспортное средство», «Займы», «Недвижимость», «Реклама (PR)», «HoReCa», «Логистика», «Аренда», «IT», «Риелторские услуги», «Охранная деятельность», «Агентские услуги», «Туристические услуги», «Оборудование/товар», «Образование», «Консалтинг», «Сведения об Обществе», «Реквизиты заседания, собрания».
- **«ИП»**: данные предпринимателя, в том числе общие реквизиты «Юридические лица и ИП».
- **«Общие переменные»**: «Контактные данные», «Банковские реквизиты», «Иные документы и реквизиты», «Договоры», «Реквизиты документов», «Пени, форс-мажор, штрафы», «Оплаты», «Авторские произведения», «Работы, услуги».

Например, в группе «Паспорт РФ» около двадцати полей: «Фамилия», «Имя», «Отчество», «Фамилия, Имя, Отчество», «Серия», «Номер», «Пол», «Дата рождения», «Место рождения», «Дата выдачи», «Код подразделения», «Адрес регистрации» и другие.

> **Совет.** **Совет.** одни и те же названия встречаются в разных группах. Например, «Номер» есть у паспорта, водительского удостоверения, военного билета и загранпаспорта. При поиске смотрите на серую подпись группы справа: у каждой группы свои подсказки и проверки. Строка поиска понимает любую часть слова, регистр не важен.

У готовой переменной нельзя изменить название и тип, но можно сделать поле необязательным и включить падеж или «прописью». Если нужно своё название или тип, [создайте свою переменную](https://datadoc.ru/ru/knowlege/u-tpl-svoya-peremennaya/llms.txt).

## Этап 2. Вставьте переменную в текст

1. Нажмите на название переменной в блоке стороны справа.
2. Метка встанет в текст там, где мигает курсор. Она выглядит как «Сторона 1.Фамилия, Имя, Отчество» на цветном фоне: до точки название стороны, после точки название переменной.
3. Нажмите **«Сохранить шаблон»**.

> **Совет.** **Совет.** курсор должен стоять в тексте шаблона. Если метка встала не туда, удалите её (см. ниже), поставьте курсор в нужное место и нажмите на переменную ещё раз.

## Этап 3. Если значение нужно в нескольких местах

Добавлять новую переменную не нужно.

1. Поставьте курсор в следующее место текста.
2. Нажмите на ту же переменную в блоке справа.
3. Повторите для каждого места.

При заполнении будет одно поле, а значение подставится во все места сразу.

![Одно поле ФИО на странице заполнения, фамилия подставлена в двух местах](https://api.forma.today/api/v1/knowledgepublic/files/e3892a01fba483fd334dfdd57a781e9b.png)

_Одно поле ФИО на странице заполнения, фамилия подставлена в двух местах_

## Меню метки «⋯»

Нажмите на метку в тексте: над ней появится кнопка **«⋯»**. Набор пунктов зависит от типа переменной.

![Меню метки: «Удалить», «Не обязательно к заполнению», «Изменить падеж»](https://api.forma.today/api/v1/knowledgepublic/files/45c9691f0cc8144e91189091af21b14c.png)

_Меню метки: «Удалить», «Не обязательно к заполнению», «Изменить падеж»_

- **«Удалить»**: убирает метку из текста. Переменная остаётся в блоке справа; если она больше нигде не нужна, при сохранении сервис предложит её убрать.
- **«Не обязательно к заполнению»**: поле можно оставить пустым ([обязательность и подсказки](https://datadoc.ru/ru/knowlege/u-tpl-obyazatelnost/llms.txt)).
- **«Изменить падеж»**: для текстовых переменных ([падежи и прописью](https://datadoc.ru/ru/knowlege/u-tpl-padezhi-propisyu/llms.txt)).
- У даты **«Текущая дата (при заполнении)»** и **«Дата прописью»**, у суммы **«Сумма прописью»**, у целого и дробного числа **«Число прописью»**.

## Как метки выглядят при заполнении

Каждая переменная становится полем на странице заполнения. Группы из блока справа становятся карточками с заголовком и счётчиком заполненных полей, поля в них идут в том же порядке, что и в блоке.

![Страница заполнения: две группы с полями, звёздочки, пометка «Не обязательно»](https://api.forma.today/api/v1/knowledgepublic/files/37e818adc0cb69b2acba3ecd43231f01.png)

_Страница заполнения: две группы с полями, звёздочки, пометка «Не обязательно»_

## Что дальше

- [Своя переменная](https://datadoc.ru/ru/knowlege/u-tpl-svoya-peremennaya/llms.txt)
- [Типы полей](https://datadoc.ru/ru/knowlege/u-tpl-tipy-poley/llms.txt)
- [Стороны документа](https://datadoc.ru/ru/knowlege/u-tpl-storony/llms.txt)