Tags de Twitter Card (X Cards): o guia atual e honesto

TL;DR — As tags de Twitter Card (agora às vezes chamadas de “X Cards”) são linhas de HTML no <head> da sua página que dizem ao X qual pré-visualização mostrar quando alguém compartilha seu link — a imagem, o título e a descrição. Você geralmente obtém isso “de graça” das suas tags Open Graph, com uma exceção: a tag twitter:card não tem outra tag que a substitua como alternativa, então você precisa defini-la. O Google não documenta essas tags como controles de pesquisa; o propósito delas é a pré-visualização do link social.

Evidência desta afirmação X Cards use page metadata to select a card type and populate a shared-link preview. Escopo: X link-preview markup behavior; rendering and product features can change. Confiança: medium · Verificado: 2026-07-14 X Developer Platform: Cards markup Evidência desta afirmação Google's supported-meta-tag reference does not treat twitter card metadata as a Google Search control. Escopo: Absence from Google's supported search-control tags supports no direct Google metadata behavior, not a universal claim about social signals. Confiança: alta · Verificado: 2026-07-14 Google Search Central: Meta tags and attributes

O que são as tags de Twitter Card

Quando você cola um link no X (antigo Twitter), ele geralmente se transforma em uma pequena caixa de pré-visualização com uma imagem, um título e uma descrição curta em vez de uma URL pura. As tags de Twitter Card são as instruções para essa caixa. Elas ficam no <head> da sua página, começam com twitter: e o X as lê para decidir como a pré-visualização fica.

Existem quatro estilos de “card”:

• summary — uma miniatura quadrada pequena ao lado do texto.
• summary_large_image — uma imagem grande, de largura total. É esta que você quer para artigos e posts de blog.
• app — um card que promove um aplicativo móvel.
• player — reproduz um clipe de vídeo ou áudio diretamente na pré-visualização.

Um conjunto básico de tags fica assim:

<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Your headline here">
<meta name="twitter:description" content="A sentence or two about the page.">
<meta name="twitter:image" content="https://example.com/preview.jpg">

A única coisa que você realmente precisa definir

Aqui está o atalho que ninguém conta para iniciantes: se você já tem tags Open Graph (as tags og: que Facebook, LinkedIn, Slack e todos os outros usam), o X vai usar essas para o título, a descrição e a imagem se as versões twitter: estiverem faltando. Então, na prática, você raramente precisa escrever todas as tags twitter:.

A única exceção é o próprio twitter:card. Não existe equivalente Open Graph para isso, então se você quiser um card com imagem grande, precisa adicionar <meta name="twitter:card" content="summary_large_image"> explicitamente. Se esquecer, o X pode mostrar um card pequeno simples ou nenhum.

A parte que surpreende as pessoas

Duas coisas que valem a pena saber antes de gastar uma tarde nisso:

1. Essas tags não ajudam você a ranquear no Google. Elas são puramente sobre como seu link fica quando é compartilhado nas redes sociais. (Mais sobre isso na aba Avançado.)
2. Um card “quebrado” no X geralmente não é culpa sua. Desde o mudança de marca da era Musk, o X mostra deliberadamente menos de qualquer post que contenha um link externo — para manter as pessoas na plataforma. Então seu card pode estar perfeitamente codificado e ainda assim ter pouco alcance. Não perca horas depurando marcação que já está correta.

Quer o quadro completo — cada propriedade, o problema de name= vs property=, tamanhos de imagem, por que o validador oficial sumiu e exatamente o que o X mudou? Mude para a aba Avançado.

TL;DR — As tags de Twitter Card são elementos <meta name="twitter:..."> que controlam a geração de prévias de links no X. Quatro tipos de card (o último conjunto documentado — não existe especificação oficial atual para reconfirmá-los): summary, summary_large_image (recomendado para artigos), app, player. Cada propriedade twitter:* usa como alternativa sua equivalente og:* — exceto twitter:card, que não tem fallback e deve ser explícita. Use name=, não property= (a causa mais comum de falha silenciosa). Essas tags são metadados de pré-visualização social, não controles documentados do Google Search; a referência de meta tags suportadas do Google não lista metadados twitter:.

Evidência desta afirmação X Cards use page metadata to select a card type and populate a shared-link preview. Escopo: X link-preview markup behavior; rendering and product features can change. Confiança: medium · Verificado: 2026-07-14 X Developer Platform: Cards markup Evidência desta afirmação Google's supported-meta-tag reference does not treat twitter card metadata as a Google Search control. Escopo: Absence from Google's supported search-control tags supports no direct Google metadata behavior, not a universal claim about social signals. Confiança: alta · Verificado: 2026-07-14 Google Search Central: Meta tags and attributes

O que são e os quatro tipos de card

As tags de Twitter Card dizem ao sistema de prévias de links do X qual prévia enriquecida gerar para uma URL compartilhada. O tipo é definido com a propriedade obrigatória twitter:card, e existem quatro:

• summary — uma pequena miniatura quadrada ao lado do título e da descrição.
• summary_large_image — uma imagem grande, de largura total. O padrão recomendado para artigos e conteúdo de blog, e o que a maioria dos editores deseja.
• app — um cartão de instalação de aplicativo móvel.
• player — uma incorporação de vídeo/áudio diretamente na prévia, controlada por twitter:player (uma URL de iframe) e twitter:player:stream (a URL de mídia bruta). Ainda funcional, embora a documentação pública sobre ele tenha diminuído consideravelmente.

Esses quatro são os últimos tipos de cartão X/Twitter documentados. Não há uma especificação oficial atual para reconfirmá-los (veja a seção de status abaixo), então considere isso como o contrato documentado legado, ainda consistentemente relatado como preciso por fontes atuais de profissionais. summary e summary_large_image são os dois que você realmente usará para conteúdo normal e os que os guias atuais discutem mais; app e player são documentados por profissionais, mas mais difíceis de verificar ao vivo sem uma referência oficial.

As propriedades principais:

Como implementá-los

Um cartão summary_large_image completo:

<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@yoursite">
<meta name="twitter:creator" content="@author">
<meta name="twitter:title" content="Your headline">
<meta name="twitter:description" content="A concise, click-worthy description.">
<meta name="twitter:image" content="https://example.com/preview-1200x630.jpg">

Sobre o dimensionamento de imagens, os números que circulam nos guias: summary quer uma imagem aproximadamente quadrada; summary_large_image quer uma larga, comumente citada em torno de 1200×630px em uma proporção aproximada de 1,91:1 (ou 2:1), abaixo de 5 MB, em JPG, PNG, WEBP, ou GIF. Como a documentação oficial diminuiu (veja abaixo), trate esses valores como consenso bem estabelecido da comunidade, em vez de uma especificação X recém-publicada.

O uso do Open Graph como alternativa — e a única tag que não pode ser substituída

Este é o fato de implementação mais importante, e é consistentemente relatado em todas as fontes atuais de profissionais que revisei: o X verifica suas tags twitter:* primeiro, depois recorre à tag Open Graph og:* correspondente, e então ao <title> da sua página e ao conteúdo da página como último recurso. Então twitter:title recorre a og:title, twitter:description a og:description, e twitter:image a og:image. Observe a ressalva que se aplica a tudo nesta página: developer.x.com não publica mais uma especificação de Cards (veja a seção de status abaixo), então isso é comportamento atual e consistente observado por profissionais, em vez de algo reconfirmado por comparação com uma especificação oficial publicada.

A exceção: twitter:card não tem equivalente no Open Graph. Não existe og:card. Se você quiser qualquer coisa diferente da renderização padrão do X, você deve definir twitter:card explicitamente. Este é o erro mais repetido em todas as fontes que revisei, e é por isso que a maioria dos sites pode depender quase inteiramente de suas tags Open Graph e apenas adicionar a linha twitter:card.

A armadilha name= vs property=

As tags de Twitter Card usam name=. As tags de Open Graph usam property=. Elas parecem intercambiáveis e não são — coloque property="twitter:card" e a tag será silenciosamente ignorada. Se suas tags OG funcionam, mas suas tags do Twitter não, verifique isso primeiro. Este é um comportamento de longa data, confirmado por profissionais; não há um contrato oficial atual do X para reverificar, então trate-o como o mesmo tipo de fato consistente e atual observado por profissionais, como a regra de fallback acima.

<!-- Correct -->
<meta name="twitter:card" content="summary_large_image">
<!-- Silently ignored -->
<meta property="twitter:card" content="summary_large_image">

O que mudou desde a mudança de marca na era Musk — a situação real em 2026

A maioria dos guias sobre este tópico ainda parece que estamos em 2019. Não estamos. Quatro coisas mudaram de verdade, e elas importam mais na prática do que qualquer detalhe de sintaxe.

1. O Validador de Cards oficial está morto. cards-dev.twitter.com/validator foi descontinuado em 2022 e o X nunca lançou um substituto. Na revisão descrita na fonte (verificado em 2026-07-18), a URL redireciona com 307 para uma página de login do X (twitter.com/login) em vez de mostrar qualquer validador. Não existe mais uma forma oficial de pré-visualizar ou depurar um card. Ferramentas de terceiros que clonam o validador proliferaram especificamente para preencher esse vazio — você pode usar uma delas para verificar sua marcação, mas saiba que nenhuma é oficial ou garantida para replicar o processo de renderização em uso do X. Qualquer guia mais antigo que diga para “testar no Twitter Card Validator” — incluindo o próprio guia de Open Graph de 2020 da Ahrefs — está fornecendo um link morto.

2. A documentação oficial de Cards simplesmente desapareceu, não está sujeita a pagamento. Uma passagem de pesquisa anterior neste artigo sinalizou que as URLs de Cards do developer.x.com retornavam uma resposta HTTP 402 Payment Required (tradução: pagamento necessário). Verificando diretamente novamente (2026-07-18, pelo status HTTP em vez do conteúdo renderizado da página), isso não é mais preciso: tanto o guia de introdução quanto a referência de marcação agora redirecionam com 307 para a página geral de docs.x.com, que não contém nenhum conteúdo específico de Cards — e o caminho equivalente em docs.x.com (espelhando a URL antiga de marcação de Cards) retorna um 404 simples. Portanto, não há especificação atual de Cards publicada oficialmente pelo próprio X nem na URL antiga nem no seu substituto em potencial — não é uma restrição de acesso pago, apenas uma ausência. O efeito prático para você é o mesmo de qualquer forma: não trate nenhuma “especificação oficial atual” como disponível para verificar detalhes de implementação.

3. A atribuição de twitter:site / twitter:creator foi degradada. As tags ainda são válidas e os plugins de CMS ainda as geram, mas o X não exibe essa atribuição de forma confiável nos cards atuais. A fonte datada mais recente que encontrei sobre isso — a base de conhecimento do The SEO Framework, atualizada em maio de 2026 — observa tanto que o X “removed much of its Twitter Card documentation, but the metadata system still works,” (tradução: “removeu grande parte da documentação do Twitter Card, mas o sistema de metadados ainda funciona”), quanto que o X “does not expose this attribution reliably in current cards.” (tradução: “não expõe essa atribuição de forma confiável nos cards atuais.”) Defina as tags; não conte com a exibição do crédito.

4. O X trata posts com links externos de forma diferente — um sistema separado da renderização do seu card. Desde aproximadamente março de 2025, o X aplica alguma forma de alcance reduzido a posts que contêm um link externo, e a própria liderança de produto da empresa confirmou que a dinâmica é intencional, visando desencorajar “lazy linking” (tradução: “compartilhamento preguiçoso de links”) e manter os usuários na plataforma. Números percentuais específicos sobre o quanto o alcance é cortado circulam amplamente na cobertura de mídias sociais; este artigo não cita um, porque nenhum número datado e de fonte primária foi verificável durante a revisão descrita na fonte — trate qualquer número exato que você vir em outro lugar como não confirmado, a menos que venha com sua própria fonte primária e atual. Como Nikita Bier, chefe de produto do X, disse quando a empresa começou a testar uma nova experiência de links no aplicativo em outubro de 2025: “For creators, a common complaint is that posts with links tend to get lower reach. This is because the web browser covers the post and people forget to Like or Reply, so X doesn’t get a clear signal whether the content is any good.” (tradução: “Para criadores, uma reclamação comum é que posts com links tendem a ter menor alcance. Isso ocorre porque o navegador cobre o post e as pessoas esquecem de curtir ou responder, então o X não recebe um sinal claro sobre se o conteúdo é bom.”)

A distinção importante, e a que a maioria dos guias de solução de problemas confunde: a renderização do card e o alcance do post são dois sistemas separados. Se os seus metadados twitter:card produzem uma prévia ou não é uma questão de marcação — verifique diretamente (tags no HTML bruto, uma ferramenta de pré-visualização, um post de teste real). Se esse post então alcança muitas pessoas é uma questão de distribuição com uma causa diferente e menos documentada. Não use um post com baixo engajamento como prova de que seu card está quebrado, e não presuma que um card que não está renderizando é “só o algoritmo” — verifique a marcação primeiro, usando o fluxo de trabalho mais adiante neste artigo, antes de atribuir um problema à supressão de alcance.

(Nota histórica que você pode ignorar operacionalmente: o X removeu os títulos das prévias de links em outubro de 2023, reverteu a decisão após reação negativa e reformatou novamente no início de 2024. Essa oscilação está resolvida — títulos e descrições são exibidos normalmente nos cards hoje quando as tags estão presentes.)

As tags Twitter Card são um fator de ranqueamento para SEO?

Não — e isso é verificável diretamente na fonte, não por paráfrase. O Google Search Central mantém uma lista exaustiva de todas as meta tags e atributos que o Google Search suporta. Pesquise por “twitter”, “og:”, “Open Graph” ou “social” e você não encontrará nada — nenhum desses termos aparece na página. Essa omissão, na referência canônica e mantida do próprio Google, é uma declaração direta (por ausência) de que o Google não processa tags Twitter Card ou Open Graph como sinais de ranqueamento ou indexação. É tão claramente um não-fator que o Google nunca precisou publicar uma negação como fez para meta keywords.

O Bing é a mesma história: não encontrei documentação do Bing sobre tags twitter:card, e o Bing não publicou orientações específicas sobre elas. Trate-as como metadados exclusivos de plataformas sociais, não como um sinal para mecanismos de busca em nenhum dos dois.

Um fato adjacente que vale manter separado para você não confundir: o Google de fato considera agora a tag og:title como uma das entradas ao gerar o título azul nos resultados de busca — mas isso é uma escolha de aparência, não um fator de ranqueamento, e é uma tag Open Graph, não uma twitter:*. Nada do namespace twitter: afeta a busca. (O elemento title em si é um tópico diferente — veja o artigo detalhado sobre tags de título neste grupo temático.)

Então o valor das Twitter Cards é exatamente uma coisa: como seu link se parece e quantas pessoas clicam nele quando é compartilhado nas redes sociais. E mesmo esse valor é prejudicado no X especificamente pela postura antilinks da própria plataforma.

Você precisa mesmo de tags Twitter se tiver Open Graph?

Na maioria dos casos, não. Por causa da regra de fallback, suas og:title, og:description e og:image cobrem as propriedades twitter: correspondentes. O mínimo pragmático para a maioria dos sites é:

• Um conjunto completo de tags Open Graph (que você quer de qualquer forma, para LinkedIn, Slack, Discord, Facebook e o uso de og:title no título do link do Google).
• Mais uma tag twitter:card explícita para escolher o tipo de card.

Adicione twitter:site/twitter:creator se quiser (inofensivo, e podem funcionar em outros locais de exibição), sabendo que a atribuição não é confiável no próprio X. Observe que o sistema de meta tags twitter:* ainda é lido por mais do que apenas o X — Discord, Slack e outros recorrem à mesma sequência de alternativas do Open Graph — então as tags continuam valendo a pena mesmo com o tratamento instável do X.

Como testar seus cards agora que a ferramenta oficial não existe mais

Como cards-dev.twitter.com/validator está morto e não há substituto oficial, trate o teste como várias verificações distintas em vez de uma única ferramenta — cada camada pode falhar de forma independente, então percorrê-las em ordem ajuda a identificar a causa real:

• Tags no HTML bruto renderizado pelo servidor — veja o HTML real servido pela página (não o DOM renderizado pelo navegador) e confirme se as meta tags twitter:*/og:* estão presentes com name=/property= corretos, antes de presumir que uma ferramenta de pré-visualização está errada.
• Acessibilidade pública — tanto a URL da página quanto a URL da imagem precisam estar acessíveis a um rastreador externo (não atrás de login, senha do ambiente de testes ou bloqueio de robots); uma imagem inacessível silenciosamente mata o card.
• Tags duplicadas ou conflitantes — alguns conjuntos de CMS e plugins geram a mesma propriedade duas vezes; a primeira ou a última instância pode vencer de forma imprevisível.
• Ferramentas de pré-visualização de card de terceiros — vários clones existem especificamente para preencher a lacuna deixada pelo validador morto. Eles pré-visualizam sua marcação; não podem garantir que espelham o processo de renderização em uso do X.
• Verificações sociais da sua ferramenta de SEO — o Site Audit da Ahrefs sinaliza um problema de “Twitter card incomplete” (tradução: “Twitter Card incompleto”) quando uma página tem metadados twitter:* parciais, e a aba “Social” da Barra de Ferramentas da Ahrefs mostra suas tags OG e Twitter Card lado a lado. Essa é uma maneira rápida de detectar um twitter:card ausente ou uma imagem vazia.
• Caches locais/CDN — se você acabou de alterar as tags, um cache de página (ou o próprio cache do X de uma URL compartilhada anteriormente) pode servir a versão antiga; limpe o cache antes de concluir que uma correção não funcionou.
• Um post de teste real — em última análise, a única maneira de ver a renderização atual real do X é compartilhar a URL e olhar, idealmente de uma conta com a qual você não se importa de testar. Trate esta etapa como verificação de renderização apenas — o alcance de um post real é uma questão separada (veja a nota sobre supressão de alcance acima) e não diz nada sobre se o card em si está correto.

Onde isso se encaixa

Este artigo aprofunda o tema do artigo central Meta Tags para SEO, no grupo de SEO on-page. Os Twitter Cards ficam na mesma categoria de “metadados de pré-visualização social” que as tags Open Graph — os dois se sobrepõem bastante e geralmente são implementados juntos, com o Open Graph fazendo a maior parte do trabalho e twitter:card preenchendo a única lacuna. É uma tag voltada para navegador/redes sociais, não uma diretiva de indexação ou exibição como a meta tag robots, e não tem influência sobre como o Google rastreia, indexa ou ranqueia a página.

Resumo de IA

Uma visão condensada da versão Avançada:

• O que são: tags <meta name="twitter:..."> no <head> que controlam a geração da prévia de links no X. Quatro tipos de cartão (o último contrato documentado; não existe especificação oficial atual para reconfirmá-lo): summary, summary_large_image (padrão para artigos), app, player.
• Propriedades principais: twitter:card, twitter:title, twitter:description, twitter:image, twitter:site, twitter:creator.
• A regra de fallback: toda propriedade twitter:* recorre à sua contraparte og:* — exceto twitter:card, que não tem equivalente no Open Graph e deve ser definida explicitamente. A maioria dos sites pode contar com o Open Graph e apenas adicionar a linha twitter:card.
• Principal pegadinha: as tags do Twitter Card usam name=, não property= (isso é do Open Graph). Misturá-los faz com que a tag seja silenciosamente ignorada.
• Status 2026 — o que o X quebrou: o Card Validator oficial foi descontinuado em 2022 e sua URL agora redireciona para uma página de login do X, não para um substituto; as URLs da documentação de Cards em developer.x.com agora redirecionam para uma página genérica de docs.x.com sem conteúdo de Cards (o caminho equivalente em docs.x.com retorna 404 — não há especificação oficial atual, nem paga); a atribuição de twitter:site/twitter:creator não é mais exibida de forma confiável; e o X aplica alcance reduzido confirmado a algumas postagens com links externos, por meio de um sistema separado daquele que renderiza o card — não use um para diagnosticar o outro.
• Não é um fator de ranqueamento: a referência exaustiva de meta tags suportadas do Google nunca menciona twitter: ou og:. O Bing também não publicou orientações. O valor é apenas CTR social. (Separadamente, o Google usa og:title — uma tag do Open Graph, não do Twitter — para a aparência do link do título, não para ranqueamento.)
• Testes: não existe mais validador oficial da plataforma. Trabalhe com tags servidas brutas, possibilidade de acesso por rastreadores externos, tags duplicadas, ferramentas de terceiros que reproduzem a função de prévia, a verificação social da sua ferramenta de SEO (o Site Audit da Ahrefs sinaliza “Twitter card incomplete” (tradução: “Twitter Card incompleto”)), caches e uma postagem de teste real como verificações separadas — o alcance de uma postagem real não diz nada sobre se o cartão foi renderizado.

Documentação oficial

Documentação de fonte primária. Observe o tema recorrente: para este tópico, as fontes “oficiais” são excepcionalmente escassas — o X removeu a documentação específica de Cards completamente (não a colocou atrás de paywall; tanto as URLs antigas quanto o site atual docs.x.com foram verificados diretamente, em 2026-07-18), e a referência relevante do Google é notável pelo que não diz.

X / Twitter

• X Developer Platform — Cards getting-started (tradução do título: Plataforma de desenvolvedores do X — primeiros passos com Cards) e Cards markup reference (tradução do título: Referência de marcação de Cards) — a documentação do próprio X; ambas as URLs agora redirecionam com 307 para a visão geral genérica de docs.x.com, que não contém conteúdo específico de Cards (verificado em 2026-07-18; um caminho equivalente em docs.x.com também retorna 404). Uma passagem anterior neste artigo relatou que essas URLs retornavam HTTP 402 — isso não é mais o que acontece.
• Legacy developer.twitter.com Cards markup (tradução do título: Documentação legada de marcação de Cards em developer.twitter.com) e getting started (tradução do título: Primeiros passos) — espelhos ainda indexados da documentação antiga (estes também agora redirecionam para docs.x.com); apenas referência histórica útil.
• cards-dev.twitter.com/validator — o Card Validator oficial, descontinuado em 2022 e nunca substituído; a URL agora redireciona para uma página de login do X (verificado em 2026-07-18). Listado para completar a referência; não confie nele.

Google

• Meta tags e atributos aceitos pelo Google — a referência exaustiva de meta tags suportadas do Google. Ela nunca menciona twitter: ou og: — a prova direta, por ausência, de que estes não são um sinal do Google.
• Como influenciar os links de título nos resultados de busca — a lista de fontes que inclui og:title (uma tag Open Graph) como uma entrada de aparência do link de título, não um fator de ranqueamento. Incluída como contraste, não como um fato sobre Twitter Cards.

Bing

• Não existe documentação específica do Bing sobre twitter:card. As Webmaster Guidelines (tradução do título: Diretrizes para webmasters) do Bing não abordam meta tags de pré-visualização social — espelhando o silêncio do Google. Trate essas tags como exclusivas de plataformas sociais para ambos os mecanismos.

Citações da fonte

Declarações registradas relevantes para este tópico. Quando uma página de origem permitiu verificação direta, o link leva diretamente à a passagem citada.

Google — documentação de meta description (o análogo suportado mais próximo, para contraste)

A referência de meta tags suportadas do Google documenta tags como a meta description em detalhes — e nunca menciona twitter: ou og: em nenhum lugar da página. Essa omissão é a evidência de que Twitter Cards não são um sinal do Google:

• “Use this tag to provide a short description of the page. In some situations, this description is used in the snippet shown in search results.” (tradução) «Use esta tag para fornecer uma descrição curta da página. Em algumas situações, esta descrição é usada no snippet exibido nos resultados de pesquisa.» — Documentação do Google Search Central, sobre a meta description (o tipo de tag que o Google de fato documenta; observe a ausência total de qualquer entrada twitter:/og: na mesma página). Ir para a citação

Liderança do X — por que posts com links têm menos alcance

• “For creators, a common complaint is that posts with links tend to get lower reach. This is because the web browser covers the post and people forget to Like or Reply, so X doesn’t get a clear signal whether the content is any good.” (tradução) «Para criadores, uma reclamação comum é que posts com links tendem a ter menor alcance. Isso ocorre porque o navegador cobre o post e as pessoas esquecem de curtir ou responder, então o X não recebe um sinal claro sobre se o conteúdo é bom.» — Nikita Bier, chefe de produto, X, sobre o teste de links no aplicativo de outubro de 2025. Leia a cobertura
• Relatado na mesma matéria, sobre a política declarada do X: postar um link com quase nenhuma descrição recebe distribuição fraca, enquanto um link acompanhado de uma descrição interessante e imagem recebe melhor distribuição — o fator causal aqui é o texto e a imagem do próprio post, separados de se seus metadados twitter:card renderizam uma pré-visualização ou não.

Base de conhecimento do The SEO Framework — uma descrição honesta da situação atual (maio de 2026)

• O X “removed much of its Twitter Card documentation, but the metadata system still works,” (tradução) «removeu grande parte de sua documentação sobre Twitter Cards, mas o sistema de metadados ainda funciona», e o X “does not expose this attribution reliably in current cards” (tradução) «não expõe essa atribuição de forma confiável nos cards atuais» em relação a twitter:site / twitter:creator. Leia a fonte

Quais tags eu realmente preciso?

Um guia rápido para as duas perguntas que as pessoas realmente têm: preciso de tags do Twitter, e qual tipo de card eu escolho?

Preciso escrever as tags twitter:*?

1. Você já tem tags Open Graph (og:) completas?
   • Não → adicione as tags Open Graph primeiro. Elas são úteis para você de qualquer forma (LinkedIn, Slack, Discord, Facebook e o uso de og:title nos links de título do Google). Depois continue.
   • Sim → seu título, descrição e imagem já têm fallback de og:*. Você só precisa adicionar uma coisa: uma tag explícita twitter:card.
2. Você quer um estilo de card específico (ex.: imagem grande)?
   • Sim → defina <meta name="twitter:card" content="summary_large_image"> (ou outro tipo). Esta tag não tem fallback de Open Graph — é a única que você não pode pular.
   • Não importa → você pode omitir, mas espere o padrão do X (geralmente um summary simples), que raramente é o que você quer para um artigo.
3. Você precisa de atribuição de autor/editor por post?
   • Adicione twitter:site e twitter:creator — mas saiba que a atribuição não é exibida de forma confiável no X em 2026. Inofensivo incluir; não dependa disso.

Qual tipo de card?

• Artigo, post de blog, página de destino → summary_large_image (imagem grande, melhor CTR).
• Link curto onde uma imagem grande é exagero → summary (miniatura pequena).
• Promovendo um aplicativo móvel → app.
• Incorporando vídeo/áudio reproduzível diretamente na prévia → player (mais twitter:player).

Meu card não está aparecendo no X — é minha marcação?

1. Suas tags OG renderizam corretamente em outros lugares (Slack, LinkedIn, uma ferramenta de prévia)?
   • Não → corrija as tags Open Graph subjacentes primeiro; o Twitter herda delas.
   • Sim → seus metadados provavelmente estão corretos. Continue.
2. Você definiu twitter:card com name= (não property=)?
   • property= → esse é o bug de falha silenciosa; mude para name=.
   • name=, correto → continue.
3. O card renderiza bem em todos os lugares que você verificou, mas o post ainda tem pouco alcance visível especificamente no X?
   • Isso é uma questão de distribuição, separada da renderização do card. O X aplica alcance reduzido confirmado a alguns posts de links externos como política da plataforma — um sistema diferente dos seus metadados, e não algo que uma meta tag possa corrigir. Alcance baixo sozinho não é prova de que o card está quebrado; confirme a renderização primeiro (passos 1-2 acima) antes de atribuir o problema à supressão de alcance.

Tags Twitter Card — folha de referência

As propriedades

Os tipos de card

Imagem (consenso da comunidade — as especificações oficiais ficaram mais enxutas)

• summary_large_image: ~1200×630px, proporção ~1,91:1 ou 2:1, abaixo de 5 MB, JPG/PNG/WEBP/GIF.
• summary: aproximadamente quadrada.

Informações rápidas

• Use name=, não property= (isso é Open Graph) — misturá-los quebra a tag silenciosamente.
• Ordem de fallback: twitter:* → og:* → <title>/conteúdo da página.
• twitter:card não tem fallback de OG — é a única tag que você sempre define.
• O Card Validator oficial foi descontinuado em 2022; sua URL agora redireciona para uma página de login do X. As URLs de Cards do developer.x.com redirecionam para uma página genérica de docs.x.com sem conteúdo de Cards — não existe especificação oficial atual.
• Não é um fator de ranqueamento do Google ou Bing — ausente por completo da referência de meta tags suportadas do Google.
• O X aplica alcance reduzido confirmado a algumas postagens com links externos (~a partir de 2025) — um sistema separado da renderização de cards; não diagnostique um card ausente a partir de baixo alcance, ou vice-versa.

Lista de verificação de implementação do Twitter Card

Uma verificação rápida para confirmar que seus cards estão configurados corretamente e evitar perder tempo com problemas que não cabe a você resolver:

• Existe um conjunto completo de tags Open Graph (og:title, og:description, og:image, og:url) — a base da qual o Twitter herda.
• Uma tag explícita twitter:card está presente (geralmente summary_large_image para artigos) — a única tag sem fallback de OG.
• Todas as tags twitter:* usam name=, não property=.
• twitter:image (ou o og:image herdado) aponta para uma imagem real e acessível — ~1200×630px, abaixo de 5 MB, JPG/PNG/WEBP/GIF.
• twitter:title / twitter:description estão definidos ou seus valores são obtidos corretamente dos equivalentes og: (não duplique desnecessariamente).
• twitter:site / twitter:creator definidos se você quiser — com a ressalva de que o X não exibe essa atribuição de forma confiável agora.
• As tags estão no <head>, não injetadas no <body>.
• Verificado com uma ferramenta de pré-visualização de terceiros e/ou a verificação social da sua ferramenta de SEO (o Site Audit da Ahrefs sinaliza “Twitter card incomplete” (tradução: “Twitter Card incompleto”)) — o validador oficial não existe mais.
• Verificação básica com uma postagem de teste real no X.
• Antes de “corrigir” um card de baixo alcance: confirme que as tags OG renderizam corretamente em outros lugares, para não estar perseguindo a supressão de postagens com links do X como se fosse um bug de marcação.

Erros comuns do Twitter Card

Erros concretos que as pessoas cometem com essas tags, por que cada um prejudica e o que fazer em vez disso.

Usar property= em vez de name= nas tags twitter:. As tags Open Graph usam property=; as tags Twitter Card usam name=. Escrever <meta property="twitter:card" content="summary_large_image"> faz a tag ser ignorada silenciosamente — sem erro, sem aviso, simplesmente não funciona. Em vez disso: sempre escreva <meta name="twitter:..."> para propriedades do Twitter, e verifique isso primeiro se suas tags OG funcionam mas seu card não.

Presumir que twitter:card usa o Open Graph como alternativa, assim como as demais propriedades. Toda outra propriedade twitter:* (title, description, image) herda de sua contraparte og:* se ausente. twitter:card não — não existe og:card. Pular isso porque “OG cobre isso” faz o X recorrer a um card padrão simples, muitas vezes não o layout de imagem grande que você queria. Em vez disso: sempre defina <meta name="twitter:card" content="summary_large_image"> (ou outro tipo) explicitamente, mesmo em uma página com tags Open Graph completas nos demais aspectos.

Confundir um card ausente com a supressão de alcance do X (ou vice-versa). A renderização do card e o alcance da postagem são dois sistemas separados. Desde cerca de março de 2025, o X aplica alcance reduzido confirmado a algumas postagens contendo um link externo — mas isso é um efeito de distribuição, independente de os metadados twitter:*/og:* realmente renderizarem um card. Assumir que a baixa visibilidade é “só o algoritmo” faz você passar por um bug real de marcação; assumir que uma postagem de baixo alcance prova que o card está quebrado faz você perseguir marcação que nunca esteve errada. Em vez disso: verifique a renderização primeiro — tags servidas em bruto, uma ferramenta de pré-visualização de terceiros, ou o card aparecendo corretamente em outra plataforma (Slack, LinkedIn) — antes de tirar qualquer conclusão sobre o alcance.

Testar cards procurando o validador oficial do Twitter Card. Guias que dizem “teste no Twitter Card Validator” estão descrevendo uma ferramenta que foi descontinuada em 2022 e nunca foi substituída — cards-dev.twitter.com/validator está morto. Seguir esse conselho desperdiça tempo procurando uma ferramenta que não existe mais. Em vez disso: use um clone de pré-visualização de card de terceiros, a verificação social da sua ferramenta de SEO (o Ahrefs Site Audit sinaliza “Twitter card incomplete” (tradução: “Twitter Card incompleto”)), ou apenas publique um link de teste real.

Contar com twitter:site/twitter:creator para mostrar atribuição de autor de forma confiável. As tags ainda são válidas e os plugins de CMS ainda as geram, mas o X não exibe consistentemente essa atribuição nos cards atuais. Confiar que a linha de autoria apareça para crédito de marca/autor não é confiável. Em vez disso: defina as tags mesmo assim (inofensivo, e outras superfícies podem usá-las), mas não trate a atribuição visível como garantida.

Gastar esforço de SEO com tags de Twitter Card esperando benefício de ranqueamento. Essas tags controlam apenas a aparência da pré-visualização social — a referência exaustiva de meta tags suportadas do Google nunca menciona twitter: ou og:. Priorizar o polimento do card em vez de sinais reais de indexação/ranqueamento direciona o esforço para a prioridade errada. Em vez disso: implemente-as para CTR social (são rápidas de adicionar via fallback do Open Graph), mas mantenha o trabalho focado em ranqueamento em tags que o Google realmente documenta.

Recursos que valem seu tempo

Meus textos relacionados

Não escrevi um artigo dedicado sobre Twitter Cards, então o contexto de primeira mão mais próximo é o trabalho mais amplo de SEO técnico onde tags sociais e do cabeçalho HTML aparecem:

• Guia de SEO técnico para iniciantes — onde tags do cabeçalho HTML e metadados sociais se encaixam no panorama geral.

Minhas palestras

• Como a busca funciona (SlideShare) — minha explicação sobre rastreamento, renderização, indexação e ranqueamento, útil para situar o que a busca faz (e não faz) com suas tags do cabeçalho HTML. (Aplica-se meu aviso padrão: esta é minha compreensão dos sistemas e pode não ser totalmente completa ou precisa.)

Fontes oficiais / primárias

• Google — meta tags e atributos aceitos pelo Google — a referência exaustiva cujo silêncio sobre twitter:/og: é a prova de que não são um sinal de ranqueamento.
• Google — como influenciar seus links de título — onde og:title (Open Graph, não Twitter) é usado para a aparência do link de título.
• Documentação legada de marcação de Twitter Cards — a referência mais antiga ainda indexada (a URL atual developer.x.com agora redireciona para uma página genérica docs.x.com sem conteúdo de Cards — verificado em 2026-07-18).

Do setor

• Twitter Cards e compartilhamento no X — The SEO Framework (atualizado em maio de 2026) — a fonte mais atual e honesta que encontrei: documenta que as tags ainda funcionam, mas a atribuição se degradou e grande parte da documentação do próprio X desapareceu.
• Ahrefs — meta tags Open Graph: tudo o que você precisa saber (Michal Pecánek, 2020) — sólido na relação de fallback entre OG e Twitter, mas note que é anterior à morte do validador e ainda diz para você testar no (agora extinto) Twitter Card Validator.
• Ahrefs — meta tags para SEO: um guia simples para iniciantes (Joshua Hardwick) — o guia mais amplo de meta tags ao qual este se junta.
• Social Media Today — X testa uma nova forma de lidar com links em publicações (Andrew Hutchinson, out. 2025) — a cobertura sobre a dinâmica de alcance de posts com links no X e o teste de links no aplicativo, com a citação de Nikita Bier.
• TechCrunch — X remove títulos das prévias de links (out. 2023) — o episódio histórico de remoção de títulos (já resolvido).

Teste-se: tags de Twitter Card

Cinco perguntas rápidas sobre como as tags de Twitter Card funcionam e o que o X mudou. Escolha uma resposta para cada uma e depois confira.

Registro de alterações