WhatsApp Preview

WhatsApp Link Preview Checker & Debugger

Test and debug how your links appear when shared in WhatsApp chats and groups

Paste multiple URLs to check Open Graph previews in bulk. We’ll analyze up to 5 pages at a time.

SEObot — AI Agent for SEO (keywords, blog, pSEO and more)

Fully automated · Syncs with Next.js, WordPress & more · Starts at $49/mo

Try SEObot free

Affiliate link — we may earn a commission at no extra cost to you.

Other Open Graph Checkers

About This WhatsApp Checker

WhatsApp is one of the most widely used messaging apps in the world, making it a major channel for link sharing, yet it is often overlooked in social media optimization. When someone shares your link in a WhatsApp chat or group, the app generates a preview card with your title, description, and image. If that preview breaks, a WhatsApp link preview checker helps you quickly see what is missing and a WhatsApp link preview debugger helps you identify which Open Graph tags need fixing.

WhatsApp relies on standard Open Graph meta tags to build link previews. That means your og:title, og:description, and og:image all matter, especially when you are testing WhatsApp link preview open graph tags or troubleshooting why an image is not showing. In many cases, the issue comes down to WhatsApp og:image requirements, image accessibility, or an unsupported file format.

For teams and creators who share links through WhatsApp every day, preview quality can have a direct impact on clicks. That is why it is useful to run a WhatsApp link preview test before publishing important pages.

How WhatsApp Generates Link Previews

WhatsApp's preview generation differs from other platforms in a few important ways. It uses Open Graph metadata to generate the card, so WhatsApp link preview open graph tags need to be accurate and accessible. The preview is compact, so title clarity and image framing matter more than in larger social cards.

When WhatsApp cannot read the image properly, the most common causes are file format issues, blocked hosting, or a mismatch with WhatsApp og:image requirements. That is why users often search for a WhatsApp link preview debugger when their preview looks fine elsewhere but fails in WhatsApp.

In practice, this means testing real URLs, checking image delivery, and confirming that the page responds correctly to WhatsApp's crawler.

Key Considerations for WhatsApp

WhatsApp's Square Image Crop

WhatsApp displays images in a compact, near-square format rather than the landscape format used by Facebook and Twitter. The center of your OG image is cropped for display. Ensure your key visual content — logo, main subject, important text — is centered in the image and remains clear and recognizable at small sizes.

Mobile-First Context

WhatsApp is almost exclusively a mobile experience. Link previews appear in a chat context where users are on small screens with limited attention. Titles should be punchy and immediately clear — there is no space for cleverness or ambiguity in a WhatsApp preview. The description is often not shown depending on the chat layout.

Network and CDN Considerations

WhatsApp generates previews using the sender's network connection. Images hosted on CDNs with strict access controls, unusual cache headers, or non-standard CORS policies may fail to load in WhatsApp previews. Ensure your og:image is served from a reliable, widely accessible CDN with standard headers.

Chat and Group Context

WhatsApp links are shared in personal chats and groups where the sharing context is highly personal. Unlike public social feeds, WhatsApp shares come with implicit trust — the recipient knows the sender personally. This means click-through rates are inherently higher, making even a basic working preview valuable.

Common WhatsApp Issues

Image Display Problems

  • WhatsApp link preview og:image WebP not showing even though the image works in a browser
  • Image not appearing in a WhatsApp link preview test because of CDN or header issues
  • Wrong portion of image showing due to WhatsApp's center-crop behavior
  • Image too small to display clearly in WhatsApp's compact preview format

Preview Generation Failures

  • No preview appearing at all when a link is pasted in WhatsApp
  • Preview showing for some recipients but not others due to network-based generation
  • Preview appearing on first share then disappearing in subsequent messages
  • HTTPS certificate issues preventing WhatsApp's crawler from fetching the page

Content Issues

  • Title truncated in WhatsApp's compact preview layout
  • Description not appearing in individual chat previews
  • Site name not displaying correctly in WhatsApp preview
  • Outdated preview persisting due to WhatsApp's local cache on the sender's device

How to Fix WhatsApp Issues

OG Tags Optimized for WhatsApp

Configure your OG tags with WhatsApp's compact, mobile preview format in mind:

<head>
  <!-- Keep title short — WhatsApp truncates aggressively -->
  <meta property="og:title" content="Short, Clear Title Under 50 Characters" />

  <!-- Description shown inconsistently — make title self-sufficient -->
  <meta property="og:description" content="Supporting context if shown. Keep under 100 characters." />

  <!-- Image centered on key content for WhatsApp's square crop -->
  <meta property="og:image" content="https://yourdomain.com/og-image-centered.jpg" />
  <meta property="og:image:width" content="1200" />
  <meta property="og:image:height" content="630" />

  <!-- Always HTTPS — WhatsApp requires secure content -->
  <meta property="og:url" content="https://yourdomain.com/your-page" />
  <meta property="og:site_name" content="Your Site Name" />
</head>

Fix CDN Headers for WhatsApp Image Loading

Configure your CDN or server to serve OG images with headers that WhatsApp's crawler accepts:

# Next.js next.config.js — Add headers for OG images
module.exports = {
  async headers() {
    return [
      {
        source: "/og/:path*",
        headers: [
          {
            key: "Cache-Control",
            value: "public, max-age=86400, stale-while-revalidate=604800",
          },
          {
            key: "Access-Control-Allow-Origin",
            value: "*",
          },
        ],
      },
    ];
  },
};

Center-Crop Safe OG Image Design

Design OG images that work both as landscape (Facebook/Twitter/LinkedIn) and center-cropped square (WhatsApp):

/*
  Design for dual-format OG images (1200x630px):

  Full image (Facebook/Twitter/LinkedIn):
  ┌──────────────────────────────────────────┐
  │  Left content  │  CENTER CONTENT  │ Right │
  │  (optional)    │  ◄ 630px wide ►  │       │
  └──────────────────────────────────────────┘

  WhatsApp crops center 630x630px:
               ┌───────────────┐
               │               │
               │  Keep logo,   │
               │  main image,  │
               │  key text     │
               │  HERE         │
               │               │
               └───────────────┘

  Strategy: Put your logo/brand in center.
  Put supporting context on sides (visible on
  desktop platforms, cropped on WhatsApp).
*/

Common Use Cases

  • Testing viral content links before sharing in WhatsApp groups
  • Verifying consumer brand links display correctly in messaging contexts
  • Checking links for markets where WhatsApp dominates (India, Brazil, Europe)
  • Debugging why WhatsApp shows no preview for certain URLs
  • Optimizing e-commerce product links shared via WhatsApp

Pro Tip

Since WhatsApp generates previews on the sender's device, test by actually sending your link to yourself in WhatsApp on a mobile device — this is more reliable than any desktop preview tool. Try it on both iOS and Android if you can, as WhatsApp's preview rendering can differ between platforms.

Frequently Asked Questions

Why is my WhatsApp link preview not showing an image?+
WhatsApp preview image failures are usually caused by one of these issues: (1) The og:image URL uses HTTP instead of HTTPS, (2) The image is hosted with restrictive CDN headers that block WhatsApp's crawler, (3) The image dimensions are too small, or (4) Your website has an SSL certificate issue preventing WhatsApp from fetching the page. Test by opening your og:image URL in an incognito mobile browser — if it loads, the URL is accessible. If not, the hosting is the issue.
How do I update a WhatsApp link preview after changing my OG tags?+
WhatsApp caches previews locally on each user's device and does not provide a way to force a global cache refresh. For the sender, deleting the message and re-pasting the link usually generates a fresh preview. For previously shared links, the old preview may persist indefinitely for recipients. The most reliable solution is using a slightly modified URL (add a query string) so WhatsApp treats it as a new link and generates a fresh preview.
Why is my og:image WebP not showing in WhatsApp link preview?+
WebP support in WhatsApp previews is inconsistent, particularly on older Android devices. WhatsApp may silently fail to load WebP images without showing any error. JPG images work most reliably across WhatsApp on both iOS and Android. PNG is also supported. Keep your file size under 300KB for fastest preview generation — WhatsApp generates previews while the link is being typed, and large images can slow or fail preview generation. If broad device compatibility matters, serve your og:image as JPG rather than WebP.
Does WhatsApp show the description in link previews?+
Inconsistently. WhatsApp's link preview format varies by context — in individual chats, descriptions are sometimes shown below the title; in group chats, only the title and image may appear due to limited space. Because description display is unreliable, make your og:title self-sufficient so the link makes sense even without the description being visible.
Why do some people see my WhatsApp link preview but others don't?+
WhatsApp generates link previews client-side on the sender's device using their internet connection. If the sender's connection was poor when they sent the link, the preview may not have generated. Additionally, WhatsApp only generates previews for links shared by humans — forwarded messages sometimes lose their previews. The inconsistency is a fundamental limitation of WhatsApp's client-side preview generation approach.