---
url: /templates/beginners/variables.md
description: >-
  Самые нужные переменные шаблонов — участник, уровень, чат, бот, топик,
  сообщение и дата — с примерами результата.
---

# Простые переменные

<p class="lead">Здесь собраны самые нужные переменные. Найдите в таблице то, что хотите подставить, скопируйте из первого столбца и вставьте в шаблон.</p>

::: info В разных местах — разные данные
Некоторые переменные есть не везде. Например, `arguments` (что написали после команды) бывает только в командах, а `level` — только в сообщении о новом уровне. Какие переменные есть в каком месте, смотрите в статье [Где используются шаблоны](../places).
:::

## Участник { #member }

`member` — участник, о котором идет речь: кто зашел в чат, вызвал команду, нажал кнопку или получил уровень.

| Переменная | Что подставится | Пример |
|---|---|---|
| `{{ member }}` | Упоминание: имя-ссылка на профиль | [Анна Смирнова](#) |
| `{{ member.name }}` | Имя и фамилия | Анна Смирнова |
| `{{ member.firstName }}` | Только имя | Анна |
| `{{ member.lastName }}` | Только фамилия (если указана) | Смирнова |
| `{{ member.username }}` | Username без @ | anna\_sm |
| `{{ member.tag }}` | @username, а если его нет — имя | @anna\_sm |
| `{{ member.displayName }}` | Должность админа в чате, а если ее нет — имя | Модератор |
| `{{ member.id }}` | Числовой ID в Telegram | 123456789 |
| `{{ member.joinedAt }}` | Когда вступил в чат | сб, 11 апр. 2026 15:27:38 MSK |
| `{{ member.warnCount }}` | Сколько активных предупреждений | 1 |
| `{{ member.language }}` | Язык Telegram участника | ru |
| `{{ member.status }}` | Статус в чате: `creator`, `administrator`, `member`, `restricted` | member |

Еще есть переменные «да/нет» — их удобно использовать в [условиях](./conditions):

| Переменная | Когда «да» |
|---|---|
| `member.isAdmin` | Участник — администратор чата |
| `member.isOwner` | Участник — создатель чата |
| `member.moderator` | Участник может модерировать: админ с правом ограничивать или роль бота «модератор» |
| `member.isPremium` | У участника Telegram Premium |
| `member.bot` | Это бот, а не человек |

## Уровень и опыт { #rank }

Если в чате включен модуль **«Уровни»**, у каждого участника есть уровень и опыт. Они лежат в `member.rank`.

| Переменная | Что подставится | Пример |
|---|---|---|
| `{{ member.rank.level }}` | Уровень | 12 |
| `{{ member.rank.totalExp }}` | Весь опыт участника | 18 430 |
| `{{ member.rank.levelCurrentExp }}` | Опыт, набранный на текущем уровне | 540 |
| `{{ member.rank.levelExp }}` | Сколько опыта нужно на текущем уровне целиком | 1 420 |
| `{{ member.rank.remainingExp }}` | Сколько осталось до следующего уровня | 880 |
| `{{ member.rank.rank }}` | Место в рейтинге чата | 7 |
| `{{ member.rank.cookies }}` | Сколько печенек участнику подарили (если печеньки включены) | 15 |

## Чат { #chat }

`chat` — чат, в котором работает бот.

| Переменная | Что подставится | Пример |
|---|---|---|
| `{{ chat.title }}` | Название чата | Клуб Astral |
| `{{ chat.memberCount }}` | Сколько участников | 1248 |
| `{{ chat.username }}` | Публичный username чата, если есть | astral\_club |
| `{{ chat.inviteLink }}` | Ссылка-приглашение (если у бота есть право приглашать) | https://t.me/+AbCd… |
| `{{ chat.owner }}` | Создатель чата (упоминанием) | [Иван](#) |
| `{{ chat.id }}` | Числовой ID чата | -1001234567890 |

::: tip Красивые числа
Чтобы 1248 выглядело как «1 248», добавьте `| number_format`:

```template
Нас уже {{ chat.memberCount | number_format }}!
```

Вертикальная черта `|` значит «передать значение в функцию». Подробнее о функциях — в [расширенном руководстве](../advanced/functions).
:::

## Бот { #bot }

`bot` — сам бот. У него те же переменные, что у участника.

| Переменная | Что подставится |
|---|---|
| `{{ bot }}` | Упоминание бота |
| `{{ bot.name }}` | Имя бота |
| `{{ bot.username }}` | Username бота |

## Топик { #topic }

Если чат — форум с топиками, `topic` — топик, куда бот отправляет сообщение.

| Переменная | Что подставится |
|---|---|
| `{{ topic }}` или `{{ topic.name }}` | Название топика |
| `{{ topic.mention }}` | Ссылка на топик |
| `{{ topic.isGeneral }}` | `true`, если это основной топик General |

## Сообщение { #message }

`message` — сообщение, из-за которого бот отвечает: вызов команды или сообщение, нарушившее правила.

| Переменная | Что подставится |
|---|---|
| `{{ message.text }}` | Текст сообщения |
| `{{ message.author }}` | Автор (упоминанием) |
| `{{ message.jumpUrl }}` | Ссылка на сообщение |
| `{{ message.createdAt }}` | Когда отправлено |

## Аргументы команды { #arguments }

Только в [пользовательских командах](/commands/). Аргументы — это то, что участник написал после команды. Если он написал `!кубик 20`, то `20` — первый аргумент.

| Переменная | Что подставится |
|---|---|
| `{{ arguments.get(1) }}` | Первое слово после команды |
| `{{ arguments.get(2) }}` | Второе слово |
| `{{ arguments.after(2) }}` | Все, начиная со второго слова |
| `{{ arguments.targetMember }}` | Участник, к которому обращена команда: на чье сообщение ответили или кого упомянули |

Подробно — в статье [Аргументы команды](/commands/arguments).

## Дата и время { #date }

| Переменная | Что подставится | Пример |
|---|---|---|
| `{{ now() }}` | Сейчас. По нажатию Telegram покажет время в часовом поясе того, кто смотрит | сб, 11 апр. 2026 15:27:38 MSK |
| `{{ date(now(), 'dd.MM.yyyy') }}` | Сегодняшняя дата в формате, который вы задали | 11.04.2026 |
| `{{ date(now(), 'HH:mm') }}` | Время по часовому поясу чата | 15:27 |
| `{{ date(member.joinedAt, 'd MMMM yyyy') }}` | Дата вступления участника | 11 апреля 2026 |

Буквы в формате даты: `dd` — день, `MM` — номер месяца, `MMMM` — месяц словом, `yyyy` — год, `HH` — часы, `mm` — минуты. Полный список — в описании функции [`date`](../advanced/functions#date).

## Когда переменной нет { #missing }

Если данных нет — например, у участника нет username, — на месте пропуска будет пусто. Чтобы подставить что-то свое, используйте `?:`:

```template
Ваш username: {{ member.username ?: 'не указан' }}
```

Знак `?:` читается как «а если пусто, то». Если username есть, выведется он, иначе — «не указан».

## Где найти остальные переменные { #more }

Здесь только самое нужное. Полные списки — в справочнике типов: [Member](/reference/member), [Chat](/reference/chat), [Rank](/reference/rank), [Topic](/reference/topic), [Message](/reference/message). Их же можно найти прямо в редакторе через кнопку **«Справочник»**.