O card do X (Twitter) não está aparecendo ou não está atualizando
O X cria o card a partir das tags twitter:, usando as tags og: como alternativa. Não há mais um validador que atualize o cache, então a solução é usar tags corretas acompanhadas de uma nova URL.
Última atualização
Solução rápida
Verifique a página com o Twitter card validator.
Defina twitter:card como summary_large_image e adicione twitter:image ou og:image.
Use uma imagem 2:1 com menos de 5 MB em JPG, PNG, WebP ou GIF.
Compartilhe a URL com ?v=2 para que o X a busque como um novo link.
Por que o card do X está ausente ou desatualizado
Não há uma tag
twitter:cardou ela está configurada para um tipo que você não queria.O robots.txt ou um firewall bloqueia o
Twitterbot. O guia de solução de problemas do X lista ambos como causas comuns.A imagem viola uma regra. O formato SVG não é compatível e os arquivos devem ter menos de 5 MB.
O X armazenou o card antigo em cache. Seu guia informa que o rastreador reindexa as tags de card aproximadamente a cada sete dias.
O URL da imagem não mudou. Os caches usam o endereço da imagem como chave, portanto, uma nova imagem precisa de um novo URL.
Como corrigir
Insira o URL no Twitter card validator para ver o card que o X criará.
Adicione
<meta name="twitter:card" content="summary_large_image">.Aponte
twitter:imageouog:imagepara uma imagem exclusiva da página, e não para o seu logotipo.Permita o Twitterbot no robots.txt e nas regras do seu CDN ou firewall.
Compartilhe o link com uma query string, como
?v=2, para forçar uma nova busca.
Tags que o X lê
twitter:card:summary_large_imageousummarytwitter:title, recorrendo aog:titletwitter:description, recorrendo aog:descriptiontwitter:image, recorrendo aog:imagetwitter:image:alt, até 420 caracterestwitter:sitepara o @nomedeusuario
Regras de tamanho de imagem
Proporção de tela 2:1 para summary_large_image
Mínimo de 300 x 157 px, máximo de 4096 x 4096 px
Menos de 5 MB
JPG, PNG, WebP ou GIF (somente o primeiro quadro); sem SVG
Como forçar uma atualização
O X não possui uma ferramenta de atualização. O Card Validator perdeu sua pré-visualização em 2022. Compartilhe o URL com uma nova query string ou altere o URL da imagem ao substituí-la. Posts já publicados mantêm seus cards. A ferramenta de atualização traz os passos para cada aplicativo.
Não verificado: o X removeu a documentação de cards do developer.x.com. As regras nesta página vêm da versão arquivada de 2024 dos documentos do X e podem ter mudado.
Fontes
Perguntas Frequentes
Qual tamanho de imagem funciona para um card summary_large_image do Twitter?
Uma imagem na proporção 2:1 entre 300 x 157 px e 4096 x 4096 px, com menos de 5 MB, em formato JPG, PNG, WebP ou GIF.
Como atualizo um Twitter card?
Não há mais um botão oficial de atualização. Compartilhe o URL com uma nova query string para que o X o busque novamente.
O X usa tags Open Graph?
Sim, como alternativa. Se twitter:title, twitter:description ou twitter:image estiverem ausentes, o X usa a versão og:.
Verifique sua página e atualize a prévia
Cole sua URL no verificador gratuito para ver as tags exatas que cada aplicativo lê. Assim que as tags estiverem corretas, use a ferramenta de atualização para limpar a pré-visualização antiga.
Guias relacionados
A prévia do link do LinkedIn não está funcionando ou não está atualizando
O LinkedIn cria o card a partir de quatro tags og: e mantém uma cópia em cache. Corrija as tags e, em seguida, faça o LinkedIn buscar a página novamente usando o Post Inspector.
O embed do Discord não está aparecendo ou não está atualizando
O Discord busca a página uma vez, lê as tags no HTML do servidor e armazena a prévia em cache por cerca de 30 minutos. Ele nunca executa o seu JavaScript.
A imagem Open Graph do Next.js não está funcionando
A maioria dos bugs de pré-visualização do Next.js vem da API de Metadados: a falta de uma metadataBase, um objeto openGraph que substitui o pai ou um arquivo de imagem que ultrapassa o limite.