Гайды

Как сделать превью ссылки (og:image) — и почему Telegram показывает старое

Иллюстрация: карточка превью вылетает из окна чата, пустая рамка заполняется картинкой

Скидываешь ссылку на свой сайт в чат — и вылезает голая синяя строка. У всех нормальных сайтов картинка с заголовком, у твоего ничего.

Чинится это четырьмя строчками в <head>. Но есть подвох: даже когда ты всё сделал правильно, Telegram упрямо продолжает показывать старый вариант — и половина людей на этом месте решает, что не получилось. Разберём и то, и другое.

Что вообще происходит, когда ты кидаешь ссылку

Мессенджер не открывает страницу как человек. Он заходит на неё роботом, читает только <head> и ищет специальные теги — Open Graph. Нашёл — построил карточку. Не нашёл — показал что попало или ничего.

То есть картинку превью выбираешь не ты в момент отправки, а твоя страница заранее. Про остальные теги в <head> есть отдельный разбор — здесь только про превью.

Пошагово: от картинки до карточки

1. Сделай картинку 1200 × 630. Это соотношение 1.91:1 — его переваривают все площадки. Буквы делай крупными: в ленте чата карточка размером с ноготь, поэтому логотип и три-четыре слова — максимум. Формат PNG или JPG, файл лучше держать до мегабайта: робот долго ждать не будет.

2. Положи её по постоянному адресу. Например, https://твойсайт.ру/og.png. Открой этот адрес в приватном окне — если картинка видна там, её увидит и робот.

3. Вставь теги в <head>.

<meta property="og:title" content="Название страницы" />
<meta property="og:description" content="Одно предложение о том, что внутри" />
<meta property="og:image" content="https://твойсайт.ру/og.png" />
<meta property="og:url" content="https://твойсайт.ру/" />
<meta name="twitter:card" content="summary_large_image" />

Последняя строка нужна X (Twitter): без неё он покажет маленькую карточку сбоку вместо большой картинки.

4. Убедись, что адрес картинки абсолютный. Это ошибка номер один. /og.png прекрасно работает у тебя в браузере, но робот приходит со стороны и не знает, от чего отсчитывать путь. Нужен полный адрес — со схемой https:// и доменом. Подробнее про то, из каких частей состоит адрес, — в отдельной статье.

5. Посмотри на страницу глазами робота. Не угадывай — проверь, что реально отдаёт сервер:

curl -s https://твойсайт.ру | grep -i "og:"

Если в консоли пусто, а на странице теги «есть» — значит, их подставляет JavaScript уже в браузере. Робот скрипты не выполняет: он получит пустой <head> и уйдёт ни с чем. Теги должны быть в ответе сервера.

6. Сбрось кэш превью. Вот тот самый момент, на котором всё обычно и застревает. Мессенджеры запоминают карточку надолго и после твоих правок продолжают показывать старую или пустую:

  • Telegram — напиши боту @WebpageBot и отправь ему свою ссылку, он обновит превью;
  • соцсети — у большинства есть свои валидаторы ссылок, они же сбрасывают кэш при проверке;
  • универсальный трюк — добавь к адресу картинки версию: og.png?v=2. Для робота это новый файл, старого кэша для него нет.

7. Проверь в живом чате. Отправь ссылку самому себе, в «Избранное». Именно отправь: если вставить её и тут же отредактировать сообщение, превью может не перестроиться.

Три грабли, на которые наступают почти все

  • Проверяешь на localhost. Робот мессенджера живёт в интернете и до твоего компьютера не дойдёт никогда. Превью проверяется только на опубликованном сайте.
  • Страница закрыта. Пароль на демо-версии, блокировка ботов, «сайт скоро откроется» — робот видит то же, что и незалогиненный человек. Ничего не увидел — карточки не будет.
  • Ссылка с редиректом. Короткие ссылки и переадресация с www иногда теряют теги по дороге. Проверяй тот адрес, который реально рассылаешь.

Что получится

Ссылка в чате раскрывается карточкой: картинка, заголовок, одно предложение описания. Кликают по такой заметно охотнее, чем по голой строке, — а стоило это пятнадцать минут один раз.

Дальше есть куда расти: сделать свою картинку для каждой страницы (для статьи — её обложка, для товара — фото товара). Правило то же самое, меняется только значение og:image. А когда страниц становится много, картинку начинают рисовать на лету — по заголовку страницы, прямо на сервере. Но это уже следующий шаг; начни с одной общей.

Если делаешь лендинг, добавь этот пункт в чеклист перед публикацией — про превью вспоминают обычно уже после того, как разослали ссылку.

Почему Telegram показывает старую картинку?

Он закэшировал превью при первой отправке. Отправь ссылку боту @WebpageBot или поменяй адрес картинки (?v=2) — тогда она считается новой.

Нужны ли отдельные теги для X (Twitter)?

Обычно хватает og-тегов: X их понимает. Добавить стоит только twitter:card со значением summary_large_image — иначе карточка будет маленькой.

У меня React или Next.js — куда вставлять?

Туда, где формируется <head> на сервере (в Next.js это metadata или <head> в лейауте). Главное — чтобы теги приходили в исходном HTML, а не дорисовывались скриптом.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →