Карточка X (Twitter) не отображается или не обновляется
X формирует карточку на основе тегов twitter:, а при их отсутствии переходит к тегам og:. Валидатора, обновляющего кэш, больше нет, поэтому решение — использовать корректные теги вместе с новым URL.
Последнее обновление
Быстрое решение
Проверьте страницу с помощью валидатора карточек Twitter.
Установите twitter:card на summary_large_image и добавьте twitter:image или og:image.
Используйте изображение с соотношением сторон 2:1 размером менее 5 МБ в формате JPG, PNG, WebP или GIF.
Поделитесь URL-адресом с параметром ?v=2, чтобы X загрузил его как новую ссылку.
Почему карточка X отсутствует или устарела
Отсутствует тег
twitter:cardили указан не тот тип, который вам нужен.robots.txt или брандмауэр блокирует
Twitterbot. В руководстве по устранению неполадок X обе эти причины указаны как наиболее частые.Изображение нарушает требования. SVG не поддерживается, а размер файла должен быть менее 5 МБ.
X сохранил в кэше старую карточку. Согласно руководству, поисковый робот выполняет повторную индексацию тегов карточки примерно каждые семь дней.
URL-адрес изображения не изменился. Кэш привязывается к адресу изображения, поэтому для нового изображения требуется новый URL.
Как это исправить
Проверьте URL с помощью Twitter card validator, чтобы увидеть карточку, которую сформирует X.
Добавьте
<meta name="twitter:card" content="summary_large_image">.Укажите в
twitter:imageилиog:imageуникальное изображение для страницы, а не ваш логотип.Разрешите доступ боту Twitterbot в robots.txt, а также в правилах вашей CDN или брандмауэра.
Опубликуйте ссылку с параметром запроса, например
?v=2, чтобы принудительно обновить данные.
Теги, которые считывает X
twitter:card:summary_large_imageилиsummarytwitter:title, если отсутствует —og:titletwitter:description, если отсутствует —og:descriptiontwitter:image, если отсутствует —og:imagetwitter:image:alt, до 420 символовtwitter:siteдля имени пользователя @username
Требования к размеру изображений
Соотношение сторон 2:1 для summary_large_image
Минимум 300 x 157 пикселей, максимум 4096 x 4096 пикселей
Менее 5 МБ
JPG, PNG, WebP или GIF (только первый кадр); SVG не поддерживается
Как принудительно обновить кэш
В X нет инструмента для сброса кэша. В 2022 году из Card Validator была удалена функция предпросмотра. Поделитесь URL-адресом с новым параметром запроса или измените URL изображения при его замене. Уже опубликованные посты сохраняют свои карточки. В инструменте обновления описаны шаги для каждого приложения.
Не проверено: X удалил документацию по карточкам с developer.x.com. Правила на этой странице основаны на архивной версии документации X за 2024 год и могли измениться.
Источники
Частые вопросы
Какой размер изображения подходит для карточки Twitter summary_large_image?
Изображение с соотношением сторон 2:1, размером от 300 x 157 до 4096 x 4096 пикселей, весом до 5 МБ, в формате JPG, PNG, WebP или GIF.
Как обновить карточку Twitter?
Официальной кнопки обновления больше нет. Поделитесь URL-адресом с новой строкой запроса, чтобы X загрузил его снова.
Использует ли X теги Open Graph?
Да, в качестве резервного варианта. Если теги twitter:title, twitter:description или twitter:image отсутствуют, X использует версию og:.
Проверьте свою страницу, затем обновите предпросмотр
Вставьте свой URL в бесплатный инструмент проверки, чтобы увидеть, какие именно теги считывает каждое приложение. Как только теги будут настроены правильно, воспользуйтесь инструментом обновления, чтобы очистить старый предпросмотр.
Похожие руководства
Предпросмотр ссылки в LinkedIn не работает или не обновляется
LinkedIn формирует превью из четырех тегов og: и сохраняет кэшированную копию. Исправьте теги, а затем обновите данные страницы с помощью Post Inspector в LinkedIn.
Встраиваемое превью в Discord не отображается или не обновляется
Discord запрашивает страницу один раз, считывает теги из HTML-кода сервера и кэширует предпросмотр примерно на 30 минут. Он никогда не выполняет ваш JavaScript.
Не работает Open Graph изображение в Next.js
Большинство ошибок превью в Next.js связаны с Metadata API: отсутствующий metadataBase, объект openGraph, заменяющий родительский, или размер файла изображения, превышающий лимит.