Discord link embeds: how to get the large image and your own color
Discord reads the same Open Graph tags as everyone else, with two extras that decide how your link looks: the card type and the color.
Discord builds the embed from your Open Graph tags. For the large image under the text, add <meta name="twitter:card" content="summary_large_image"> and a 1200 × 630 og:image. Add <meta name="theme-color" content="#f2541b"> to color the stripe on the left.
The tags Discord reads
| Part of the embed | Tag |
|---|---|
| Small text above the title | og:site_name |
| Bold, linked title | og:title |
| Text under the title | og:description |
| Image | og:image (absolute https URL) |
| Image size and placement | twitter:card |
| Stripe on the left | theme-color |
Like every crawler, Discord's doesn't run JavaScript, so the tags must be in the HTML your server sends. Paste your URL into the link preview checker to see what it reads.
Large image or small thumbnail
Discord's documentation says twitter:card changes the layout. With summary_large_image the image is shown large under the text; without it, many embeds show a small thumbnail on the right. Some third-party guides claim Discord ignores Twitter tags; Discord's own docs say otherwise, so set it and check.
Use a 1200 × 630 JPG or PNG. The same image works on X, LinkedIn and Slack; see the OG image size guide.
The side stripe color
theme-color must be a hex color: #RRGGBB or #RRGGBBAA. Names like orange or rgb() values are ignored. It's the same tag that tints the address bar on Android, so use your brand color.
Updating an old embed
Discord caches embeds. There's no public refresh tool: post the link with a new query string (?v=2) and it's fetched as a new URL. Old messages keep the old embed.
Get the large embed right
Launchpack makes a 1200 × 630 OG image and the tags, theme-color included. Free for the OG image.
Questions
Why is my Discord embed image small?
Add <meta name="twitter:card" content="summary_large_image"> and use a wide image (1200 × 630). Without the large card type Discord often shows a small thumbnail.
How do I change the color of a Discord embed?
Add <meta name="theme-color" content="#RRGGBB"> with a hex color to your page's head.
Why does Discord show an old preview?
Discord caches embeds. Share the URL with a new query string, such as ?v=2, to make it fetch the page again.