WhatsApp link preview debugger: the only tool that simulates WhatsApp

    WhatsApp has over two billion users but no official link preview debugger. If your WhatsApp shares display as bare URLs with no thumbnail, no title, and no description, there is no way to diagnose why using Meta's own tools.

    This free WhatsApp link preview debugger is the only tool that simulates WhatsApp's crawler directly. We fetch any URL using WhatsApp's exact user-agent string, extract every Open Graph tag WhatsApp reads, and show you the raw HTML response - the same content WhatsApp receives when someone pastes your link in a chat.

    Paste a URL below to fix broken WhatsApp previews before you send another message.

    How to use this tool

    1. 1

      Enter the link you want to send. WhatsApp is preselected on this page.

    2. 2

      Click 'Simulate crawl' to request the page with a WhatsApp user-agent.

    3. 3

      Check the 'Social preview card' for the title, description and thumbnail a chat would show.

    4. 4

      Confirm og:title, og:description and og:image appear under 'Open Graph tags detected', and that the image URL is absolute and uses HTTPS.

    5. 5

      Send the link to yourself in WhatsApp to confirm. If an old preview persists, add a harmless query string such as ?v=2 so WhatsApp treats it as a new link.

    How it works

    We request your URL with the header 'WhatsApp/2.23.20.0' and extract the Open Graph tags from the response. The card shown here uses the same title, description and image fields WhatsApp reads.

    WhatsApp differs from other platforms in where the preview is made. It is generated by the sender's app when the link is typed or pasted, before the message is sent, and the finished preview travels with the message. That is why recipients see the same card the sender saw, why a preview cannot be corrected after sending, and why Meta offers no debugger for it.

    WhatsApp is stricter about images than Facebook. Keep the og:image file small, because large files are often skipped and the link falls back to text only, and serve it over HTTPS from a URL that needs no cookies or redirects. If the tags are present here but chats still show a bare link, the image is the first thing to check, followed by any rule on your server that treats unfamiliar user-agents differently.

    Understanding WhatsApp

    WhatsApp is the world's most popular messaging platform with over 2 billion users. When someone shares a link in a WhatsApp chat, the app fetches the page to generate an inline preview showing a title, description, and thumbnail image. These previews are critical for click-through rates in private and group chats.

    WhatsApp's link preview system does not execute JavaScript. It reads Open Graph meta tags (og:title, og:description, og:image) from the raw HTML response. If your JavaScript framework renders these tags client-side, WhatsApp displays the link as a plain URL with no preview - dramatically reducing the likelihood that recipients will click through.

    WhatsApp link previews are particularly important for e-commerce, content marketing, and customer communication. When a customer service agent shares a product link, or when a user forwards an article to a group chat, a rich preview with an image and description provides context and builds trust. A bare URL looks unprofessional and suspicious.

    Pre-rendering ensures WhatsApp's crawler receives your OG tags in the raw HTML, producing rich link previews that display correctly in every chat conversation.

    Frequently asked questions

    Why does my WhatsApp link show no preview?▾

    WhatsApp reads OG tags from raw HTML without executing JavaScript. If your og:title, og:description, or og:image tags are injected by a JavaScript framework, WhatsApp cannot see them. Use this tool to check whether your OG tags are present in the raw HTML.

    How long does WhatsApp cache link previews?▾

    WhatsApp caches link previews aggressively. Once a preview is generated, it may not refresh for days or weeks. If you fix your OG tags, existing cached previews in chats will not update, but new shares will show the correct preview.

    Does WhatsApp use its own crawler or Facebook's?▾

    Its own. WhatsApp identifies itself with a 'WhatsApp/2.x' User-Agent, and the preview is generated by the sender's app when the link is typed, not by Facebook's crawler. Both read the same Open Graph tags, so fixing those tags fixes the preview on both platforms.

    Related crawler tests

    Related free tools

    Make every crawler see your content

    PageGlass automatically serves rendered HTML to all bots. No per-crawler configuration needed - one simple change covers Googlebot, AI crawlers, and social platforms.

    We use cookies. Privacy Policy