What metadata does Discord use for link embeds?

Discord primarily reads og:title, og:description, og:image, and og:site_name. It also respects the theme-color meta tag to set the accent bar color on embeds.

Why is my Discord link not showing an embed?

The most common causes are: the page is not publicly accessible (Discord cannot crawl auth-gated pages), the og:image URL is not reachable by Discord's crawler, or the page is missing Open Graph tags entirely.

How do I change the color of the Discord embed accent bar?

Add a tag to your page. Discord reads this to set the left-side accent bar color on embeds.

How can I preview my Discord link embed before sharing?

Paste your URL into peek to see exactly how Discord will render your link in a chat channel (including the accent color, image, title, and description).

Discord Link Preview Guide

Discord automatically embeds website links in chat. It reads Open Graph tags to populate the embed title, description, and image. Some behavior is empirically observed rather than officially documented.

Preview with Discord →

Tags Discord reads

Tag	Used as	Confidence
og:title	Embed title (blue link)	High
og:description	Embed body text	High
og:image	Image inside embed	High
og:site_name	Provider name above title	Inferred
theme-color	Accent bar color	Inferred

Key requirements

→ The page must be publicly accessible (Discord cannot embed auth-gated pages).
→ The image URL must be directly reachable by Discord's crawler.
! Discord's exact embed rules are not fully documented, some visual behavior is inferred from testing.

Recommended tags

<meta property="og:title" content="My Post Title" />
<meta property="og:description" content="A short description." />
<meta property="og:image" content="https://example.com/og.jpg" />
<meta property="og:url" content="https://example.com/my-post" />
<meta property="og:site_name" content="My Site" />
<meta name="theme-color" content="#5865F2" />

Frequently asked questions

What metadata does Discord use for link embeds?: Discord primarily reads og:title, og:description, og:image, and og:site_name. It also respects the theme-color meta tag to set the accent bar color on embeds.
Why is my Discord link not showing an embed?: The most common causes are: the page is not publicly accessible (Discord cannot crawl auth-gated pages), the og:image URL is not reachable by Discord's crawler, or the page is missing Open Graph tags entirely.
How do I change the color of the Discord embed accent bar?: Add a <meta name="theme-color" content="#your-hex-color" /> tag to your page. Discord reads this to set the left-side accent bar color on embeds.
How can I preview my Discord link embed before sharing?: Paste your URL into peek to see exactly how Discord will render your link in a chat channel (including the accent color, image, title, and description).