How Discord link previews work: Open Graph, oEmbed, and the embed cache

Discord generates link embeds using og:title, og:description, and og:image tags. When a user posts a URL in a Discord channel, Discord's servers fetch the page, extract the OG tags, and cache the result. The embed appears automatically with no user action needed. The image shows at up to roughly 400x210 in the embed.

Platform or focus
Platforms
Social media and messaging apps
Topic detail
Discord embeds
discord-embeds

How this is calculated

Discord's embed cache is aggressive and hard to bust. Once Discord fetches your OG tags, it may cache them for hours or days. Changing the tags on your server won't immediately update embeds already posted. The workaround is to append a query parameter (?v=2) to the URL, which forces Discord to re-fetch. Also, if og:image is missing or too small, Discord won't show any image in the embed. The minimum recommended size is 400x210. For best results, use a 1200x630 image and Discord will scale it down. Discord also respects og:site_name, og:video for embedded video, and theme-color for the embed's left border color.

Verdict

Discord embeds are fully OG-compatible. Use standard 1200x630 images. If you update your OG tags and need embeds to refresh, add a cache-busting query parameter. Test in a private Discord server before sharing publicly.

More OG scenarios

Frequently asked questions

What are Open Graph meta tags?
Open Graph meta tags are snippets of code in your website's <head> that control how your page appears when shared on social media. They allow you to define a specific title, description, and image that platforms like Facebook, Discord, and LinkedIn will display.
Why do I need a separate twitter:card tag?
While many platforms fallback to Open Graph (og:) tags, Twitter uses its own specific meta tags (twitter:card, twitter:image, etc.) to format link previews. Providing both ensures maximum compatibility across all platforms.
What is the best image size for Open Graph?
The recommended size for an Open Graph image is 1200x630 pixels. This creates a 1.91:1 aspect ratio, which is the standard size used by almost all major social platforms for large preview cards.
How do I test if my tags are working live?
Once deployed, you can use official debuggers like the Facebook Sharing Debugger or the Twitter Card Validator. This visualizer tool helps you preview and generate the tags locally before you deploy them.