og:image wordt niet weergegeven? Zo los je het op
Een og:image die niet wordt weergegeven, komt bijna altijd door een van vijf oorzaken: de afbeeldings-URL is niet openbaar, de afbeelding is te groot, het platform heeft een oude versie in de cache opgeslagen, de tags verwijzen naar de verkeerde pagina, of het afbeeldingsformaat wordt niet ondersteund. Deze handleiding behandelt elke oplossing met de debugtools die Facebook, X en LinkedIn bieden.
Waarom wordt mijn og:image niet weergegeven?
Meestal is de afbeeldings-URL niet openbaar ophaalbaar, overschrijdt het bestand de limieten van het platform, of toont het platform een gecachte kopie. Sociale platforms herscrapen volgens een schema en cachen agressief, dus een nieuwe afbeelding lijkt vaak "niet te werken" totdat je een verversing forceert met hun debugtools.
De vijf meest voorkomende oorzaken (en oplossingen)
1. De afbeeldings-URL is niet openbaar
Platforms moeten de afbeelding kunnen ophalen zonder authenticatie. Een URL achter een login, localhost of een IP-adres zal falen.
Oplossing: host de afbeelding op een openbare, HTTPS-URL en bevestig dat curl -I <image-url> 200 OK retourneert met een afbeelding Content-Type.
2. De afbeelding is te groot
De meeste platforms hanteren een limiet van 8 MB voor OG-afbeeldingen (X ongeveer 5 MB). Een grote PNG faalt stilzwijgend.
Oplossing: houd het bestand onder 5 MB; een 1200×630-tekstkaart is meestal 200–500 KB. Op FastOG is de PNG-uitvoer hier al op afgestemd.
3. Het platform heeft een oude versie gecachet
Facebook, X, LinkedIn, Slack en Discord cachen allemaal agressief. Meta slaat ook een eigen kopie van de afbeelding op en koppelt de preview aan de pagina-URL, dus een nieuwe afbeeldings-URL alleen is niet voldoende. Na het wijzigen van de afbeelding blijft de oude kaart uren of dagen bestaan.
Oplossing: forceer een scrape met de tool van het platform (hieronder). Gebruik voor wisselende afbeeldingen een URL die meeverandert met de inhoud (FastOG's ondertekende URLs doen dit automatisch). Voor het ene platform dat een programmatische verversing toestaat, zie Forceer een Facebook Open Graph Cache Refresh.
4. Verkeerde URL of verkeerde pagina
De og:image-tag kan ontbreken, gedupliceerd zijn of verwijzen naar een pagina zonder die tag.
Oplossing: bekijk de paginabron en bevestig dat de og:image-tag aanwezig is, server-rendered en absoluut.
5. Niet-ondersteund formaat
Sommige platforms wijzen bepaalde formaten of geanimeerde afbeeldingen af.
Oplossing: gebruik PNG of JPG; 1200×630 is de ondersteunde verhouding.
Debugtools
| Platform | Tool |
|---|---|
| Facebook / WhatsApp | Sharing Debugger — developers.facebook.com/tools/debug |
| X / Twitter | Card Validator — cards-dev.twitter.com/validator |
Post Inspector — linkedin.com/post-inspector |
Plak de URL en klik op "Scrape" / "Refresh" om de nieuwste tags op te halen.
FastOG-specifiek
- FastOG rendert 1200×630 PNG — het ondersteunde formaat — zodat problemen met grootte of verhoudingen worden vermeden.
- Ondertekende URL's beperken alleen de eerste render; gecachte afbeeldingen blijven geldig, dus een gedeelde kaart blijft werken.
- Wijzig de titel → wijzig de URL → één nieuwe render. Het platform pikt (uiteindelijk) de nieuwe kaart op wanneer je een herscraping forceert.
FAQ
Garandeert FastOG dat mijn og:image verschijnt?
FastOG levert een geldige 1200×630 PNG vanaf een openbare URL. Of het platform deze toont, hangt af van de cache ervan — scrap opnieuw met de validator nadat je een afbeelding hebt gewijzigd.
Waarom toont Facebook een oude afbeelding, zelfs nadat ik deze heb bijgewerkt?
Facebook cached scrapes en bewaart een eigen kopie van de afbeelding — dus een nieuwe og:image-URL alleen is niet voldoende. Gebruik Sharing Debugger → "Scrape Again"; Force a Facebook Open Graph Cache Refresh behandelt de API-route, de app-token die nodig is en de snelheidslimieten waarmee je rekening moet houden.
Hoe dwing ik X om mijn nieuwe kaart te tonen?
Open de X Card Validator en plak de URL. Deze haalt de nieuwste og:image en twitter:image opnieuw op.