Как сделать превью ссылки (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 коротких урока на телефоне.





