Карточка X (Twitter) не отображается или не обновляется

X формирует карточку на основе тегов twitter:, а при их отсутствии переходит к тегам og:. Валидатора, обновляющего кэш, больше нет, поэтому решение — использовать корректные теги вместе с новым URL.

Последнее обновление

Быстрое решение


  1. Проверьте страницу с помощью валидатора карточек Twitter.

  2. Установите twitter:card на summary_large_image и добавьте twitter:image или og:image.

  3. Используйте изображение с соотношением сторон 2:1 размером менее 5 МБ в формате JPG, PNG, WebP или GIF.

  4. Поделитесь URL-адресом с параметром ?v=2, чтобы X загрузил его как новую ссылку.


Почему карточка X отсутствует или устарела

  • Отсутствует тег twitter:card или указан не тот тип, который вам нужен.

  • robots.txt или брандмауэр блокирует Twitterbot. В руководстве по устранению неполадок X обе эти причины указаны как наиболее частые.

  • Изображение нарушает требования. SVG не поддерживается, а размер файла должен быть менее 5 МБ.

  • X сохранил в кэше старую карточку. Согласно руководству, поисковый робот выполняет повторную индексацию тегов карточки примерно каждые семь дней.

  • URL-адрес изображения не изменился. Кэш привязывается к адресу изображения, поэтому для нового изображения требуется новый URL.

Как это исправить

  1. Проверьте URL с помощью Twitter card validator, чтобы увидеть карточку, которую сформирует X.

  2. Добавьте <meta name="twitter:card" content="summary_large_image">.

  3. Укажите в twitter:image или og:image уникальное изображение для страницы, а не ваш логотип.

  4. Разрешите доступ боту Twitterbot в robots.txt, а также в правилах вашей CDN или брандмауэра.

  5. Опубликуйте ссылку с параметром запроса, например ?v=2, чтобы принудительно обновить данные.

Теги, которые считывает X

  • twitter:card: summary_large_image или summary

  • twitter:title, если отсутствует — og:title

  • twitter:description, если отсутствует — og:description

  • twitter:image, если отсутствует — og:image

  • twitter: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 в бесплатный инструмент проверки, чтобы увидеть, какие именно теги считывает каждое приложение. Как только теги будут настроены правильно, воспользуйтесь инструментом обновления, чтобы очистить старый предпросмотр.