Skip to main content
← Blog

Discord Link Preview Not Working? Fix It

Why Discord embeds fail and how to fix missing images, wrong titles, and empty link previews.

Discord builds link embeds from Open Graph tags — the same og:title, og:description, and og:image that Facebook uses. When a preview fails on Discord, the root cause is almost always a missing or unreachable OG tag.

How Discord reads your page

Discord's crawler fetches your URL and parses <meta property="og:..."> tags from the HTML response. It does not run JavaScript. SPAs that set meta tags client-side will show empty or broken embeds.

Discord also displays og:site_name as a small label above the title — a nice branding touch most other platforms skip.

Required tags for Discord embeds

<meta property="og:title" content="Your title" />
<meta property="og:description" content="Short description." />
<meta property="og:image" content="https://example.com/og.jpg" />
<meta property="og:url" content="https://example.com/page" />
<meta property="og:site_name" content="Your Brand" />

Common Discord-specific issues

Empty embed

No og:title or og:description in server-rendered HTML. Fix: add tags to <head> server-side.

Image not showing

  • Image URL is relative instead of absolute
  • Image returns 403/404 to Discord's bot
  • Image exceeds size limits (keep under ~10 MB, ideally under 1 MB)
  • og:image points to a redirect chain that fails

Wrong or stale preview

Discord caches embeds aggressively. After fixing tags, append a cache-busting query string to the URL when re-sharing, or wait for the cache to expire.

Embed suppressed by the site

Some sites send X-Robots-Tag: noindex or block Discord's user agent. Check your server logs and CDN rules.

Discord vs. other platforms

Discord does not use Twitter Card tags. It relies entirely on Open Graph. If your preview works on X but not Discord, you likely have twitter:* tags but broken or missing og:* tags.

Test your URL

Paste your link into OpenGraph Check and switch to the Discord preview tab to see exactly what Discord's crawler will embed — before you post in a server.