Home/ Guides/ WhatsApp link preview

Guide · Open Graph

Why your WhatsApp link preview isn't showing.

WhatsApp reads the same Open Graph tags as everyone else — but it's fussy about the image and it caches hard, with no debugger to lean on. Here's what kills the preview, and how to bring it back.

Updated June 27, 2026 · by slsh.me

The short answer

WhatsApp builds the card from your og:image, og:title and og:description. The image must be an absolute https URL, publicly reachable, and under ~300 KB — or the thumbnail silently disappears.

Reads og:title / description / image Image https, < ~300 KB Debugger None Refresh Change the URL

WhatsApp caches the preview per exact URL, so editing your tags isn't enough on its own — an old fetch sticks. The fix is to make WhatsApp see a new URL (a query string like ?v=2), which forces it to re-read the tags.

Want to see the exact title, description and image WhatsApp will pull — before you paste the link in a chat? The free slsh.me Open Graph checker fetches your page and renders the card, no login required.

Why the preview is blank.

Almost every missing WhatsApp preview comes down to one of these. Each maps to a one-line fix in your page's <head>.

Symptom Cause Fix
No image, text onlyThe og:image is missing, relative, or behind a login / robots block.Add an absolute og:image (https://…) on a public URL.
Image declared but still droppedThe file is too heavy — WhatsApp skips large images.Compress under ~300 KB; a 1200 × 630 JPEG/PNG is fine.
Tiny thumbnail, not a big cardWhatsApp can't tell the image dimensions.Declare og:image:width and og:image:height.
No preview at allThe page isn't reachable over HTTPS, or it 301-redirects the crawler.Serve a 200 over HTTPS; don't block WhatsApp's fetch.
Old image / title persistsWhatsApp cached an earlier scrape of that exact URL.Append a query string (?v=2) to bust the cache — see below.

Force a fresh preview.

WhatsApp has no "Scrape Again" button. Because it caches per exact URL, the trick is to make it fetch a URL it hasn't seen.

Fix the tags first

Set a valid absolute og:image, og:title and og:description in your page's <head> and deploy. Confirm the page returns 200 over HTTPS.

Add a throwaway query string

Append something like ?v=2 (or ?utm_source=whatsapp) to the link. WhatsApp treats example.com/page and example.com/page?v=2 as different URLs, so it can't serve the stale cache.

Paste the new URL into a chat

Type the variant into the message box and wait a second for the card to render — before you hit send. WhatsApp fetches the tags fresh for that URL.

Share the clean link

Once the preview looks right, you can send that URL — or, if you prefer the bare link, a freshly minted short link is a brand-new URL WhatsApp has never cached.

There's no WhatsApp debugger.

WhatsApp ships no preview-inspection tool. Facebook has the Sharing Debugger and LinkedIn has Post Inspector, but WhatsApp gives you nothing — your only feedback loop is pasting the link into a real chat and squinting at the result, which also pollutes the cache for that URL.

You can check the tags without WhatsApp at all. WhatsApp reads the public Open Graph spec, so any checker that fetches your page reports the exact og:title, og:description and og:image WhatsApp would use — and renders the card for every other platform in the same pass.

The free slsh.me Open Graph checker fetches your page, lists every og: and twitter: tag, runs a best-practices audit (image size included), and renders the real card on WhatsApp, Facebook, X, LinkedIn, Slack, Discord and iMessage — no login needed.

Check your tags on the free Open Graph checker

Want the card right the first time? Shorten your link on slsh.me and design its Open Graph card in seconds — free.

Questions

Why is my WhatsApp link preview not showing? +
WhatsApp builds the preview from your page's og:title, og:description and og:image. If the image tag is missing, points to a relative path instead of an absolute https URL, sits behind a login or robots.txt block, or is too large, WhatsApp drops the thumbnail and shows a plain text preview — or nothing. It also caches per exact URL, so an old fetch can stick after you fix the tags.
What image size does WhatsApp need? +
Keep the og:image well under about 300 KB — WhatsApp silently skips images that are too heavy. Use an absolute https URL, a publicly reachable file, and a standard 1200 × 630 image compressed under that limit. Declaring og:image:width and og:image:height helps WhatsApp render the large card instead of a tiny thumbnail.
How do I force WhatsApp to refresh a preview? +
WhatsApp has no public debugger or "Scrape Again" button, and it caches per exact URL. Change the URL so WhatsApp treats it as new — append a query string such as ?v=2 — then paste that variant into a chat. WhatsApp fetches the tags fresh for the new URL.
Is there a WhatsApp link preview debugger? +
No. Unlike Facebook's Sharing Debugger or LinkedIn's Post Inspector, WhatsApp ships no inspection tool. Because it reads the standard Open Graph tags, a third-party checker that fetches your page shows the same title, description and image WhatsApp will use — so you can fix the tags before you share.

Ship a link that previews right.

Shorten any URL with slsh.me and design its Open Graph card — title, description, image — once. It ships valid, lightweight tags WhatsApp reads on the first fetch, and you get live click analytics for free.

Create a link with slsh.me

Free forever · see pricing