VK строит карточку не из того DOM, который вы видите после работы браузерного JavaScript, а из данных, доступных его загрузчику. Поэтому начните с сырого ответа. Если `og:image` появляется только после hydration, закрыт геоблоком или ведёт на HTML вместо картинки, ручная перепубликация ссылки ничего не исправит.

Симптом «нет превью» и симптом «старое превью» требуют разного первого действия. При пустой карточке ищут сбой получения или разметки. При старой — сначала убеждаются, что новый HTML уже доступен извне, и только затем сбрасывают кеш конкретного адреса.

Каскад останавливается на первом неуспешном ответе

ШагПроверкаТипичная поломка
Страница200 после допустимых redirect403, login, bot protection
HTML headog:title, og:type, og:url, og:imageТеги только в JavaScript
Изображение200, image/*, разумный размерHTML error под URL картинки
Канонический URLog:url соответствует страницеВсе карточки указывают на главную
Кеш VKОбновление после починкиСохранена старая карточка

Open Graph находится в исходном head

<meta property="og:title" content="Как выбрать тариф">
<meta property="og:type" content="article">
<meta property="og:url" content="https://example.com/blog/tariff/">
<meta property="og:image" content="https://cdn.example.com/og/tariff.jpg">
<meta property="og:image:type" content="image/jpeg">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="Таблица сравнения тарифов">
<meta property="og:description" content="Короткое сравнение условий без скрытых доплат.">

Open Graph определяет четыре базовых свойства: title, type, image и url. Остальные помогают описать объект и изображение. Используйте абсолютные адреса. Если тег повторяется, протокол отдаёт предпочтение первому значению сверху, поэтому конфликтующий блок плагина может выигрывать у нового.

URL картинки проверяется как отдельный ресурс

  • Откройте точный og:image без cookies, Referer и авторизации.
  • Проверьте конечный HTTP status после redirect и корректный `Content-Type: image/...`.
  • Убедитесь, что TLS-сертификат действителен и цепочка не возвращается на HTTP.
  • Не отдавайте hotlink-заглушку ботам и внешним площадкам.
  • Не ставьте изображение за одноразовой signed URL, которая скоро истечёт.
  • Укажите ширину, высоту, тип и alt рядом с тем же корневым og:image.

Проверка изображения в обычном браузере может быть ложноположительной: браузер уже авторизован или хранит кеш. Нужен чистый внешний запрос. Если CDN преобразует формат по Accept, проверьте, что неизвестный клиент получает обычный поддерживаемый image response, а не страницу ошибки.

Пустая карточка отличима от старой

НаблюдениеВероятный слойЧто делать
Нет title и imageСтраница недоступна/нет OGPage response и source
Title новый, image нетImage fetchStatus, MIME, redirect
Всё староеКеш или старый origin HTMLСравнить source, затем clear cache
У всех URL одна карточкаНеверный og:url/шаблонДанные страницы в head
Работает только с ?v=2Кеш маскирует проблемуОбновить origin и точный URL

Кеш очищают после исправления источника

В API VK существует метод `pages.clearCache` для внешних страниц, прикрепляемых к публикациям. Используйте его в соответствии с актуальной документацией и правами приложения, передавая точный URL без токена в логах или статье. Если кеш очистить раньше, VK снова сохранит тот же неправильный HTML.

  1. Получить свежий HTML страницы и убедиться, что новые OG-теги уже опубликованы.
  2. Получить картинку внешним запросом и записать status, MIME и конечный URL.
  3. Сверить og:url с адресом, который пользователи вставляют в VK.
  4. Очистить кеш этого URL официальным методом или инструментом аккаунта.
  5. Создать одну тестовую публикацию и сравнить заголовок, изображение и описание.
  6. Не менять URL массово, пока один контрольный адрес не работает стабильно.

Результат принят, когда внешний клиент получает корректный HTML и изображение без сессии, OG относится к конкретной странице, а после обновления кеша VK формирует ожидаемую карточку. Для разбора нужны source head, два набора response headers и точный URL без персональных параметров.

Проверенные источники