Quando condividi un link in una qualsiasi app moderna (un post, un messaggio privato, un canale Slack), la piattaforma scarica l'URL ed estrae un piccolo insieme di metadati per mostrare una *scheda di condivisione*: il titolo, una descrizione, un'immagine e il nome del sito. Quei metadati non vengono presi dalla pagina visibile, ma da un insieme specifico di tag <meta> nell'<head>. Il protocollo Open Graph, inventato da Facebook nel 2010, ne definisce la maggior parte. X (ex Twitter) aggiunge qualche extra con il prefisso twitter:. LinkedIn, Discord, Slack, iMessage, WhatsApp e Pinterest leggono tutti gli stessi tag con piccole variazioni.
Impostare bene questi tag è un lavoro da fare una volta per pagina, ma ha un impatto enorme. Una pagina senza immagine Open Graph sembra rotta quando viene condivisa. Un titolo troppo lungo viene tagliato a metà parola. Un og:image con le proporzioni sbagliate viene incorniciato con bande da tutte le piattaforme. Questo strumento ti permette di regolare questi valori con anteprime dal vivo, così vedi i problemi di troncamento e ritaglio *prima* di pubblicare la pagina.
Tutto funziona in locale. Lo stato del modulo, le anteprime e l'HTML generato non lasciano mai il tuo browser: puoi incollare URL non ancora pubblicati e testi riservati senza preoccuparti di fughe di informazioni.
Cosa impari usandolo
I tag Open Graph usano l'attributo property (<meta property="og:title">), mentre i tag SEO standard e quelli Twitter Card usano name (<meta name="description">, <meta name="twitter:card">).
Se il traffico dalle condivisioni conta, titolo e descrizione vanno impostati in *tre* posti: SEO standard (title, meta description), Open Graph (og:title, og:description) e Twitter (twitter:title, twitter:description).
og:image dovrebbe essere 1200×630, servita in HTTPS e indicata con un URL assoluto: i percorsi relativi falliscono quando altri server scaricano la pagina.
Il valore di twitter:card su X controlla il layout: summary è una piccola miniatura quadrata, summary_large_image è il banner a tutta larghezza che vuole la maggior parte dei brand.
Come scrivere i tag Open Graph passo dopo passo
1
Scrivi un titolo breve e incisivo
Punta a 50-60 caratteri. Facebook tronca intorno ai 95 caratteri e X intorno ai 70. Metti prima il valore, non il brand: "Come fare il deploy con Cloudflare Workers" funziona meglio di "Blog di Coddy · Guida al deploy".
2
Scrivi una descrizione di una frase
Punta a 120-155 caratteri. La maggior parte delle piattaforme tronca intorno ai 200. Usa frasi complete: la descrizione compare sotto il titolo in ogni scheda, e i frammenti tagliati sembrano incompiuti.
3
Imposta l'URL canonico
Usa l'URL https:// assoluto della pagina stessa, non un link di tracciamento o di reindirizzamento. I crawler Open Graph seguono og:url per deduplicare le condivisioni: un URL canonico mantiene coerenti conteggi e anteprime.
4
Fornisci un URL assoluto per l'immagine
1200×630 è la misura ideale per le schede summary_large_image su X e per le schede standard su Facebook e LinkedIn. PNG o JPEG, sotto i 5 MB circa. Usa sempre un URL assoluto: i percorsi relativi falliscono perché il crawler del social visita l'URL dal proprio server.
5
Copia i tag generati
Incolla il blocco del pannello **Tag <head> generati** nell'<head> della tua pagina. Dopo il deploy, verifica con il debugger di ogni piattaforma (Facebook Sharing Debugger, X Card Validator, LinkedIn Post Inspector) e forza una nuova scansione se in seguito cambi l'immagine.
Riferimento dei tag Open Graph e Twitter Card
I tag qui sotto coprono tutto ciò che le piattaforme social leggono oggi. I tag indicati con property= appartengono al protocollo Open Graph; quelli indicati con name= sono le varianti SEO standard e Twitter Card. Specifiche di riferimento: Open Graph, X Cards.
Tag
Usato da
Consigliato
Note
og:title
FB, LinkedIn, Slack, Discord
50-60 caratteri
Se manca, si usa il <title>: impostalo comunque.
og:description
FB, LinkedIn, Slack, Discord
120-155 caratteri
Se manca, si usa la meta description.
og:image
Tutte le piattaforme
1200×630, < 5 MB, HTTPS, URL assoluto
Deve essere un URL assoluto: i percorsi relativi falliscono.
og:image:alt
Accessibilità
Descrivi l'immagine
Usato dagli screen reader e da alcune piattaforme.
og:url
FB, LinkedIn
URL canonico https://
Serve a deduplicare le condivisioni tra varianti con query string.
Mostrato come piccola attribuzione sopra o sotto la scheda.
twitter:card
X
summary_large_image
summary per una piccola miniatura quadrata, summary_large_image per il layout a banner.
twitter:title
X
Uguale a og:title
Se manca, X usa og:title: impostali entrambi per sicurezza.
twitter:description
X
Uguale a og:description
Se manca, si usa og:description.
twitter:image
X
Uguale a og:image
Se manca, si usa og:image.
twitter:site
X
@tuobrand
L'handle X dell'editore: alimenta alcune statistiche.
Schemi Open Graph da provare
Articolo di blog (article)
Imposta **og:type** su article, aggiungi **Autore** e **Data di pubblicazione** nella sezione dedicata agli articoli e usa un'immagine di copertina 1200×630. Le anteprime si aggiornano per mostrare come appare la scheda su ogni piattaforma.
og:type=article sblocca i tag specifici degli articoli (article:published_time, article:author) che alcune piattaforme (Discord, LinkedIn) usano per mostrare l'attribuzione. Twitter li ignora ma non si lamenta.
Pagina prodotto o landing page
Lascia **og:type** su website. Usa il nome del prodotto come titolo, una proposta di valore di una frase come descrizione e un'immagine principale o il ritaglio di uno screenshot come immagine.
Le landing page non hanno bisogno di metadati da articolo. L'elemento più cliccato della scheda di una landing page condivisa è di solito l'immagine, quindi investi in un'immagine pulita da 1200×630.
Pagina di documentazione
Titolo: "Concetto - Sezione · Docs". Descrizione: una frase che spiega il concetto. Immagine: una copertina generica della documentazione o uno screenshot dell'interfaccia pertinente.
Le pagine di documentazione vengono condivise nei canali Slack e nei thread di X. Un'immagine di copertina coerente le rende riconoscibili in un feed affollato ancora prima che si legga il titolo.
Errori comuni con Open Graph
Usare un URL relativo per og:image, come /images/cover.png. I crawler dei social visitano la tua pagina dai *loro* server: i percorsi relativi puntano al dominio della piattaforma e restituiscono 404. Usa sempre un URL https:// assoluto.
Dimenticare twitter:card. Senza, X usa una scheda minimale senza immagine. Aggiungi twitter:card=summary_large_image per ottenere il layout a banner che vuole quasi ogni brand.
Saltare il tag og:image:alt. Non costa nulla, aiuta chi usa uno screen reader e alcune piattaforme lo mostrano come testo alternativo nella scheda.
Lasciare che Facebook tenga in cache una vecchia immagine e poi lamentarsi che l'anteprima non si aggiorna. Rifai la scansione con il Facebook Sharing Debugger ogni volta che cambi og:image.
Creare immagini di condivisione dinamiche che richiedono più di 10 secondi per essere generate. I crawler dei social vanno in timeout in fretta: se la tua immagine viene generata al volo, preparala in anticipo o mettila in cache.
Domande frequenti sull'anteprima Open Graph
Che cos'è Open Graph?
Open Graph è un protocollo pubblicato da Facebook nel 2010 che permette a una pagina web di descriversi con un piccolo insieme di tag <meta>: titolo, descrizione, immagine, tipo e così via. Oggi lo leggono tutte le principali piattaforme social e di chat, ed è per questo che è diventato lo standard di fatto per i metadati delle schede di condivisione.
Twitter Card o Open Graph: servono entrambi?
Usali entrambi. X (Twitter) ripiega dai suoi tag twitter: agli equivalenti og: quando quelli specifici di X mancano, quindi tecnicamente potresti cavartela solo con Open Graph. Ma aggiungere twitter:card, twitter:site e twitter:creator ti dà un controllo più preciso su come la scheda appare su X.
Che dimensione deve avere og:image?
1200×630 pixel (un rapporto di 1,91:1) è la misura più sicura. Facebook, LinkedIn e X mostrano tutti bene queste proporzioni. Tieni il file sotto i 5 MB circa e servilo in HTTPS con un URL assoluto: i percorsi relativi falliscono quando altri server scaricano la tua pagina.
Perché la mia anteprima non si aggiorna su Facebook?
Facebook mette in cache le schede di condivisione in modo aggressivo. Dopo aver cambiato i meta tag, incolla l'URL nel Facebook Sharing Debugger e fai clic su *Scrape Again*. Lo stesso trucco funziona su X con il Card Validator e su LinkedIn con il Post Inspector.
Google usa i tag Open Graph?
Per il posizionamento no: il crawler di Google legge il contenuto della pagina, il tuo <title> e la meta description. Google a volte usa og:image per la ricerca immagini e per Discover, ma non è un fattore di ranking.
Posso generare automaticamente un'immagine diversa per ogni pagina?
Sì, la maggior parte dei framework supporta immagini Open Graph dinamiche. Next.js ha la OG Image Generation API, SvelteKit e Astro hanno soluzioni simili. Genera l'immagine al momento della richiesta e mettila in cache in modo aggressivo: i crawler dei social vanno in timeout rapidamente.