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
https://justosmanali.com
Example: justosmanali.com. Previews are approximations: actual appearance may vary.
What Discord shows when you share a link
| Part of the preview | Shown? | Comes from |
|---|---|---|
| Site name | Shown | Site name (og:site_name) |
| TitleShown as a link. | Shown | Sharing title (og:title) |
| Description | Shown | Sharing description (og:description) |
| ImageLarge with the large X card type, otherwise a thumbnail at the side. | Shown | Sharing image (og:image) |
| Colour stripGrey when no colour is set. | Sometimes | Your theme colour (theme-color) |
https://justosmanali.com
How Discord builds link embeds
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-colorchanges 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
✕Discord shows a small image on the side instead of a big one
Your page doesn’t ask for the large card.
FixSet the X card type to “summary_large_image” in your website or SEO plugin settings.
How to Make Your Website Look Better on Social Media →✕Discord shows an old preview
Discord saved the preview from an earlier share.
FixPost the link with ?v=2 added to the end.
Why Is My Website Link Not Showing a Preview? →✕The colour strip is grey
Your page doesn’t set a theme colour.
FixAdd a theme colour (theme-color) using your brand colour, if your website builder offers it.
How to Make Your Website Look Better on Social Media →
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
- The Open Graph protocol: The tags most apps read to build link previews.
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.