Quando você compartilha um link no X (antigo Twitter), a plataforma tenta gerar uma prévia — o chamado Twitter Card. Sem as meta tags corretas, seu link aparece como uma URL simples. Com Twitter Cards adequadamente configurados, no entanto, o X puxa um título, descrição e imagem, transformando seu link compartilhado em um teaser visual no qual as pessoas têm muito mais probabilidade de clicar.
O que exatamente é exibido?
Um Twitter Card não é algo que você envia ou projeta. Ele é gerado automaticamente pelo X com base em meta tags no HTML da página linkada. Quando alguém cola sua URL em um tweet, o rastreador do X visita a página, lê as meta tags e monta a prévia. Se as tags estão ausentes ou mal configuradas, a prévia fica incompleta ou ausente por completo.
Os dois tipos de card que importam
O X suporta vários tipos de card, mas, na prática, você só encontrará dois:
- Summary Card — Uma prévia compacta com uma pequena miniatura à esquerda e o título e descrição à direita. Isso é o que a maioria dos posts de blog, artigos e páginas de documentação usa. A miniatura é quadrada, normalmente de pelo menos 144×144 pixels.
- Summary Card with Large Image — A imagem ocupa toda a largura acima do texto. Isso funciona bem para páginas de destino, páginas de produto, peças de portfólio ou qualquer página onde o visual é o principal atrativo. A imagem deve ter pelo menos 300×157 pixels, idealmente 1200×628 para exibição nítida em telas de alta resolução.
Costumavam haver tipos adicionais (Player Card para áudio/vídeo, App Card para aplicativos móveis), mas a maioria dos sites nunca precisará deles.
As meta tags que você precisa
Coloque-as na seção <head> da sua página:
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Título da Sua Página" />
<meta name="twitter:description" content="Uma breve descrição da sua página." />
<meta name="twitter:image" content="https://example.com/image.jpg" />
<meta name="twitter:site" content="@SeuPerfil" />A tag twitter:card determina o layout. A tag twitter:site é opcional, mas adiciona seu perfil como atribuição abaixo do card.
O fallback do Open Graph
Aqui vai algo que muitos proprietários de site não percebem: o X recorrerá às tags Open Graph (aquelas usadas pelo Facebook, LinkedIn e WhatsApp) se as tags específicas do Twitter estiverem ausentes. Então, se você já tem og:title, og:description e og:image definidos, seu link ainda renderizará uma prévia no X — apenas sem o controle explícito que as tags do Twitter Card oferecem.
Na prática, isso significa que um plugin de SEO bem configurado como Yoast ou Rank Math frequentemente cuida do básico automaticamente. Mas confiar no fallback tem desvantagens: as dimensões da imagem podem não ser ideais para o layout do X, e a descrição pode ser truncada de forma diferente. Para o resultado mais limpo, configure ambos os conjuntos de tags.
Problemas comuns na prática
Mesmo quando as tags estão presentes, as coisas podem dar errado:
- Problemas de cache — O X faz cache das prévias dos cards de forma agressiva. Se você corrigir uma imagem quebrada ou atualizar um título, a prévia antiga pode persistir por dias. Você pode forçar uma atualização usando a ferramenta Card Validator do X.
- Imagem muito pequena — Se sua imagem está abaixo do tamanho mínimo, o X pode ignorá-la inteiramente e não mostrar nenhuma imagem de prévia.
- URLs relativas — O valor de
twitter:imagedeve ser uma URL absoluta. Caminhos relativos como/images/header.jpgnão funcionam. - Robots bloqueando o rastreador — Se seu
robots.txtbloqueia o Twitterbot, o X não consegue ler suas meta tags e não gerará um card.
Como o WordPress lida com Twitter Cards
O WordPress em si não exibe meta tags de Twitter Card por padrão. Você precisa de um plugin de SEO (Yoast SEO, Rank Math, The SEO Framework) ou de um plugin dedicado de redes sociais para gerá-las. A maioria desses plugins permite que você defina um tipo de card padrão para todo o site e substitua a imagem e descrição por post ou página.
Se você está executando o WooCommerce, verifique suas páginas de produto separadamente — às vezes elas precisam de configuração adicional, porque a imagem e descrição do produto devem ser puxadas dos dados do produto, não dos campos genéricos da página.
Como o InspectWP ajuda
O InspectWP lê as meta tags em seu site WordPress e mostra exatamente quais tags de Twitter Card estão presentes — ou ausentes. O relatório exibe o tipo de card detectado, título, descrição, URL da imagem e perfil do site, para que você possa verificar se a prévia ficará da maneira que você deseja antes de compartilhar seu conteúdo.