Discord embed preview

Discord turns links into embeds with a coloured bar, site name, title, description and a large image. Check yours and fix it before you post in a server.

What Discord reads

Discordbot reads og:site_name, og:title, og:description and og:image, and uses <meta name="theme-color"> for the vertical bar on the left of the embed. With twitter:card set to summary_large_image the image appears full width under the text; otherwise Discord may show a thumbnail on the right.

  • Title: up to 256 characters are shown.
  • Description: long text is shown, up to roughly 350 characters, so it’s the one place a longer pitch works.
  • theme-color: any hex colour, e.g. #c2186b.

Frequently asked questions

How do I change the colour of my Discord embed?

Add <meta name="theme-color" content="#yourcolour"> to the page head. Discord caches embeds, so test with a new query string.

Why is my Discord embed image small?

Add <meta name="twitter:card" content="summary_large_image">. Without it Discord often uses the thumbnail layout.

How long does Discord cache embeds?

Discord does not publish a number and caches aggressively. Adding ?v=2 (or any new query) to the URL fetches a fresh embed.