iMessage Open Graph Meta Tags & Specs
The exact Open Graph specifications for Apple's iMessage. Ensure your links generate beautiful rich link previews in iOS and macOS Messages.
Updated December 2025 3 min read
Quick Answer
iMessage reliably loads standard Open Graph tags. However, it requires a secure URL (`https`) everywhere and is strict about file size and caching. The recommended image is 1200x630px.
iMessage Image Specs
Recommended Size
1200 ร 630px
Aspect Ratio: 1.91:1.
File Limitations
Max 10MB
Formats: JPG, PNG, GIF
Required Meta Tags
Basic HTML
html
<!-- Standard Open Graph Requirements -->
<meta property="og:title" content="Your Page Title" />
<meta property="og:description" content="Your compelling description" />
<meta property="og:image" content="https://example.com/image.jpg" />
<meta property="og:url" content="https://example.com/page" />
<!-- Helpful Additional Tag -->
<link rel="apple-touch-icon" href="https://example.com/icon.png" />Nuxt 3
typescript
useSeoMeta({
ogTitle: 'Your Page Title',
ogDescription: 'Your compelling description',
ogImage: 'https://example.com/image.jpg',
ogUrl: 'https://example.com/page',
})Next.js
typescript
export const metadata = {
openGraph: {
title: 'Your Page Title',
description: 'Your compelling description',
images: [{
url: 'https://example.com/image.jpg',
width: 1200,
height: 630,
}],
url: 'https://example.com/page',
type: 'website'
},
icons: {
apple: 'https://example.com/icon.png',
}
}Top 3 Best Practices
- Use HTTPS for all image paths. iMessage strictly refuses to load preview images served via HTTP.
- Include the Apple Touch Icon. Use
<link rel="apple-touch-icon" href="...">to provide a site icon representing the source link domain. - Expect caching. iMessage caches link previews on Apple's servers very intensely. Append a cache-buster query parameter to the link if testing.
Troubleshooting
My Image Won't Appear in iMessage
If your image doesn't appear in iMessage, check if the URL provided in og:image is fully qualified and uses https://. Also, make sure Apple's bot isn't blocked by your web server or firewall.
Test Your iMessage Link Previews
Preview how your links will appear in iMessage and all other platforms instantly.
Try the Free Preview Tool