og:image non visibile? Come risolverlo
Un'og:image non visibile quasi sempre dipende da una di cinque cause: l'URL dell'immagine non è pubblico, l'immagine è troppo grande, la piattaforma ha memorizzato nella cache una versione vecchia, i tag puntano alla pagina sbagliata o il formato dell'immagine non è supportato. Questa guida illustra ogni soluzione con gli strumenti di debug forniti da Facebook, X e LinkedIn.
Perché la mia og:image non viene visualizzata?
Nella maggior parte dei casi l'URL dell'immagine non è accessibile pubblicamente, il file supera i limiti della piattaforma, oppure la piattaforma mostra una copia in cache. Le piattaforme social eseguono nuovamente lo scraping a intervalli programmati e fanno un uso aggressivo della cache, quindi una nuova immagine spesso sembra "non funzionare" finché non forzi un aggiornamento con i loro strumenti di debug.
Le cinque cause più comuni (e le relative soluzioni)
1. L'URL dell'immagine non è pubblico
Le piattaforme devono recuperare l'immagine senza autenticazione. Un URL dietro un login, localhost o un indirizzo IP fallirà.
Soluzione: ospita l'immagine a un URL HTTPS pubblico e verifica che curl -I <image-url> restituisca 200 OK con un'immagine Content-Type.
2. L'immagine è troppo grande
La maggior parte delle piattaforme impone un limite di 8 MB per le immagini OG (X circa 5 MB). Un PNG enorme fallisce silenziosamente.
Soluzione: mantieni il file sotto i 5 MB; una card testuale 1200×630 pesa di solito 200–500 KB. Su FastOG, l'output PNG è già dimensionato per questo.
3. La piattaforma ha memorizzato nella cache una versione vecchia
Facebook, X, LinkedIn, Slack e Discord fanno tutti un uso intensivo della cache. Meta inoltre conserva una propria copia dell'immagine e associa l'anteprima all'URL della pagina, quindi un nuovo URL dell'immagine da solo non basta. Dopo aver cambiato l'immagine, la vecchia card persiste per ore o giorni.
Soluzione: forza una scansione con lo strumento della piattaforma (sotto). Per immagini che cambiano, usa un URL che varia con il contenuto (gli URL firmati di FastOG lo fanno automaticamente). Per l'unica piattaforma che consente un aggiornamento programmatico, vedi Forzare un aggiornamento della cache Open Graph di Facebook.
4. URL sbagliato o pagina sbagliata
Il tag og:image potrebbe mancare, essere duplicato o puntare a una pagina priva di quel tag.
Soluzione: visualizza il sorgente della pagina e verifica che il tag og:image sia presente, renderizzato lato server e assoluto.
5. Formato non supportato
Alcune piattaforme rifiutano determinati formati o immagini animate.
Soluzione: usa PNG o JPG; 1200×630 è il rapporto supportato.
Strumenti di debug
| Piattaforma | Strumento |
|---|---|
| Facebook / WhatsApp | Sharing Debugger — developers.facebook.com/tools/debug |
| X / Twitter | Card Validator — cards-dev.twitter.com/validator |
Post Inspector — linkedin.com/post-inspector |
Incolla l'URL, poi premi "Scrape" / "Refresh" per recuperare i tag più recenti.
Specifiche di FastOG
- FastOG genera PNG 1200×630 — la dimensione supportata — evitando così problemi di dimensioni o proporzioni.
- Gli URL firmati limitano solo il primo rendering; le immagini memorizzate nella cache restano valide, quindi una card condivisa continua a funzionare.
- Modifica il titolo → cambia l'URL → un nuovo rendering. La piattaforma (alla fine) rileva la nuova card quando forzi un nuovo scraping.
FAQ
FastOG garantisce che la mia og:image venga visualizzata?
FastOG fornisce un PNG valido di 1200×630 da un URL pubblico. Se la piattaforma lo mostri o meno dipende dalla sua cache — esegui nuovamente lo scraping con il validatore dopo aver modificato un'immagine.
Perché Facebook mostra una vecchia immagine anche dopo che l'ho aggiornata?
Facebook memorizza nella cache gli scraping e conserva una propria copia dell'immagine — quindi un nuovo URL og:image da solo non basta. Usa Sharing Debugger → "Scrape Again"; Forza un aggiornamento della cache Open Graph di Facebook copre la rotta API, il token dell'app necessario e i limiti di frequenza da rispettare.
Come faccio a forzare X a mostrare la mia nuova card?
Apri il Card Validator di X e incolla l'URL. Recupera nuovamente gli ultimi og:image e twitter:image.