Skip to content

Discord Link Preview

How links look on Discord

In Discord, a shared link becomes an “embed”: a box with your site name, the page title, a description and an image, with a coloured strip down the left side. Discord reads the same sharing information as Facebook and X, and it uses your website’s theme colour for that strip.

Check how your link looks on Discord

Platform behaviour last reviewed 15 November 2026

Osman AliToday at 9:41 AM

https://justosmanali.com

Example: justosmanali.com. Previews are approximations: actual appearance may vary.

What Discord shows when you share a link

Part of the previewShown?Comes from
Site nameShownSite name (og:site_name)
TitleShown as a link.ShownSharing title (og:title)
DescriptionShownSharing description (og:description)
ImageLarge with the large X card type, otherwise a thumbnail at the side.ShownSharing image (og:image)
Colour stripGrey when no colour is set.SometimesYour theme colour (theme-color)
Osman AliToday at 9:41 AM

https://justosmanali.com

Example: a Discord embed. The strip on the left uses the website’s theme colour.

When a link is posted in a Discord channel or message, Discord fetches the page and reads its Open Graph tags (the same sharing information Facebook uses) plus a couple of extras:

  • The X card type. With summary_large_image, the image appears large under the text. Without it, Discord usually shows a small thumbnail on the right.
  • Your theme colour. A setting called theme-color changes the colour of the strip down the left of the embed. Many website builders set this from your brand colour.

Discord doesn’t publish official documentation for website embeds, so the behaviour on this page is based on how Discord displays links in practice.

When embeds don’t appear

  • The person who posted the link removed the embed, or wrapped the link in angle brackets (<https://...>), which hides the embed.
  • The person viewing has link previews turned off in their settings.
  • The page needs a login or blocks Discord’s visitor.

Common Discord preview problems

Recommended image specifications for Discord

Each line says whether it comes from Discord’s own documentation, our testing, or our advice.

Recommended size
1200 × 630 px
Our advice
Large image
Needs the “summary_large_image” card type
Observed
File size
Under 1 MB
Our advice

How to refresh an old Discord preview

Discord keeps previews it has already fetched. After fixing your page, post the link with ?v=2 added to the end to get a fresh embed.

Sources

Discord link preview questions

Discord uses your website’s theme colour (a tag called theme-color). Set it to your brand colour in your website settings or theme, if your builder supports it.

Discord shows a large image only when your page uses the large X card type (summary_large_image). Otherwise it shows a thumbnail.

Related guides

See how your link looks on Discord

Free, instant, no account.