Launchpack by Świt Studio

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.

Short answer

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 embedTag
Small text above the titleog:site_name
Bold, linked titleog:title
Text under the titleog:description
Imageog:image (absolute https URL)
Image size and placementtwitter:card
Stripe on the lefttheme-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.

Make my 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.

Keep reading