WhatsApp Open Graph Meta Tags & Specs
The exact Open Graph specifications for WhatsApp. Learn how to display images and descriptions correctly in WhatsApp link previews.
Updated December 2025 3 min read
Quick Answer
WhatsApp requires smaller images to ensure previews load. Recommended size is 300x200px (or a small square), and the image file must be under 300KB to appear reliably in chats.
WhatsApp Image Specs
Recommended Size
1200 × 630px
Automatically downscaled. Direct small images (300x200) work best if below 300KB.
File Limitations
Max 300KB
If larger, WhatsApp may omit the image preview entirely.
Required Meta Tags
Basic HTML
html
<!-- WhatsApp Requirements (Standard OG) -->
<meta property="og:title" content="Your Page Title" />
<meta property="og:description" content="Your compelling description" />
<!-- CRITICAL: Image must be under 300KB! -->
<meta property="og:image" content="https://example.com/image-optimized.jpg" />
<meta property="og:url" content="https://example.com/page" />
<meta property="og:type" content="website" />Nuxt 3
typescript
useSeoMeta({
ogTitle: 'Your Page Title',
ogDescription: 'Your compelling description',
ogImage: 'https://example.com/image-optimized.jpg',
ogUrl: 'https://example.com/page',
ogType: 'website',
})Next.js
typescript
export const metadata = {
openGraph: {
title: 'Your Page Title',
description: 'Your compelling description',
images: [{
url: 'https://example.com/image-optimized.jpg',
width: 1200,
height: 630,
}],
url: 'https://example.com/page',
type: 'website'
}
}Top 3 Best Practices
- Compress images heavily. The absolute most common reason WhatsApp previews fail is the image being over 300KB.
- Include standard Open Graph tags. WhatsApp reads
og:title,og:description, andog:image. - Provide a square fallback. Although landscapes work, a 1:1 image prevents cropping issues in smaller mobile contexts.
Troubleshooting
My Image Won't Appear in WhatsApp
If your image doesn't appear when tested in a chat, it is almost certainly because the image file size is over 300KB. Optimize your image file size immediately. Use formats like JPEG for photos to save space.
Test Your WhatsApp Link Previews
Preview how your links will appear on WhatsApp and all other platforms instantly.
Try the Free Preview Tool