Validatore di Twitter Card

Quando qualcuno condivide il tuo link su X (Twitter), la piattaforma legge i meta tag twitter: della pagina per costruire la card di anteprima: il suo formato, il titolo, la descrizione, l’immagine e l’attribuzione. Se questi tag mancano, il link viene pubblicato come un semplice URL, senza card. Incolla l’HTML della tua pagina qui sotto e questo validatore controlla che i tre tag obbligatori, twitter:card, twitter:title e twitter:description, siano presenti, mostrando il valore che legge da ciascuno così puoi sistemare un’anteprima rotta prima di pubblicare.

Come validare la tua card

  1. 1

    Incolla l'HTML della tua pagina

    Puoi incollare solo la sezione `<head>` o l'intero documento. Il validatore controlla solo i tag `<meta>`, quindi ogni altro markup viene ignorato.

  2. 2

    Cerca i tre tag obbligatori

    `twitter:card`, `twitter:title` e `twitter:description`, il minimo necessario per qualsiasi tipo di card. Altri tag come `twitter:image` non vengono controllati qui.

  3. 3

    Guarda cosa è stato trovato

    Ogni tag corrispondente viene elencato con il valore letto dal suo attributo `content`, così puoi controllare al volo il testo.

  4. 4

    Correggi ciò che manca

    Qualsiasi dei tre che manca viene segnalato come assente. Aggiungilo al tuo `<head>` e incolla di nuovo l'HTML per ricontrollare.

I quattro tipi di Twitter Card

Il formato è definito dal valore twitter:card. Questo validatore legge il valore che indichi; i quattro supportati da X sono:

Tipo di card Valore twitter:card Uso tipico
Riepilogo summary Articoli e pagine di contenuto standard
Riepilogo con immagine grande summary_large_image Articoli di blog con un’immagine di copertina
Player player Audio o video incorporato
App app Link di installazione app con metadati dello store

Tag obbligatori e consigliati

Questo strumento controlla solo il primo gruppo, i tre tag di cui X ha bisogno per qualsiasi card.

Obbligatori (controllati qui):

  • twitter:card, il formato da usare
  • twitter:title, il titolo (X mostra all’incirca i primi 70 caratteri)
  • twitter:description, il riepilogo (X mostra all’incirca i primi 200 caratteri)

Consigliati (non controllati qui, ma da aggiungere):

  • twitter:image, un URL assoluto https:// a un PNG, JPG o GIF; almeno 300 x 157 px per una card riepilogo e 800 x 418 px per summary_large_image
  • twitter:site, l’@handle del tuo brand
  • twitter:creator, l’@handle dell’autore
  • twitter:image:alt, testo alternativo per l’accessibilità

Errori comuni

  • Solo tag Open Graph. X ripiega su og:title, og:description e og:image, quindi il link viene comunque mostrato, ma senza twitter:card il formato predefinito è un piccolo riepilogo. Includi entrambi i set quando puoi.
  • Immagine troppo piccola. Sotto i 300 x 157 px la card può ridursi al solo testo.
  • URL dell’immagine relativo. twitter:image deve essere assoluto (https://...); un percorso relativo viene ignorato.
  • property= invece di name=. X, e questo validatore, leggono i tag di Twitter da name="twitter:...". Scrivere property="twitter:..." funziona per Open Graph ma non per questi.
  • Descrizione troppo lunga. Oltre i 200 caratteri circa X la taglia, di solito a metà parola.

Come vedere la card reale

X ha ritirato il suo validatore di card ufficiale (cards-dev.twitter.com/validator) nel 2023, quindi non esiste più una pagina ufficiale che mostri un’anteprima dal vivo. Questo strumento conferma che i tag obbligatori sono presenti e leggibili; per vedere la card reale, condividi il link in una bozza di post o in un messaggio diretto a te stesso, oppure usa un controllo di anteprima link di terze parti. Se X continua a mostrare una vecchia immagine dopo che hai corretto i tag, aggiungi una stringa di query come ?v=2 all’URL dell’immagine per aggirare la sua cache.

Domande frequenti

No. Legge l’HTML che incolli e conferma che i tre tag twitter: obbligatori sono presenti, mostrando il valore di ciascuno. Non disegna la card e non accede alla tua pagina online. X ha chiuso il suo validatore di card nel 2023, quindi il modo affidabile per vedere la card reale è condividere il link in una bozza di post o in un messaggio diretto a te stesso.

X ripiega su og:title, og:description e og:image, quindi il link viene comunque mostrato, ma senza twitter:card il formato predefinito è un piccolo riepilogo. Per una card con immagine grande devi impostare esplicitamente twitter:card su summary_large_image. Nota che questo validatore controlla solo i tag twitter:, non i tuoi tag og:.

Cerca name="twitter:..." con l’attributo content scritto dopo il nome, tra virgolette singole o doppie. Se il tuo tag usa property="twitter:..." invece di name=, o mette content prima di name, il pattern non corrisponderà anche se l’HTML è valido. Rimettilo nell’ordine name="..." content="..." e ricontrolla.

Questo validatore riconosce il nome indipendentemente dal maiuscolo/minuscolo, quindi twitter:Card viene rilevato anche qui. Tienili comunque in minuscolo (twitter:card), perché è la forma che X documenta e si aspetta.

Brevemente, sì. Il controllo viene eseguito sul nostro server, quindi l’HTML che incolli viene inviato lì, analizzato ed eliminato. Conserviamo solo una traccia anonima dell’uso dello strumento, mai il tuo markup, e non è uno strumento offline che funziona nel browser.

Strumenti correlati

Strumento disponibile in altre lingue