How Discord builds a link preview
When a link is posted, Discord’s crawler (its user agent contains Discordbot) downloads the page and reads its Open Graph tags. Each one fills a part of the embed:
og:site_name— the small line at the top of the embed.og:title— the blue heading, which links to the page.og:description— the text under the heading.og:image— the picture. With<meta name="twitter:card" content="summary_large_image">it is shown full width under the text; without it, Discord shows a small thumbnail on the right.<meta name="theme-color" content="#5865F2">— the coloured strip down the left edge. Without it the edge stays a neutral grey.
Discord reads the raw HTML without running JavaScript, so tags that a single-page app adds after loading are invisible to it.
See which of these tags your page has, and what Discord will show.
Check a URLWhy your Discord preview is missing or wrong
Embeds are switched off for you
Discord has a per-user setting, under Chat in User Settings, that hides embeds and link previews. If nobody else is missing the embed, check this on your own account first.
The channel does not allow embeds
Posting embeds needs the Embed Links permission. In a channel where your role lacks it, every link is posted as plain text, no matter how good the page’s tags are.
The embed was suppressed
A link wrapped in angle brackets, like <https://example.com>, is posted without an embed on purpose. The author of a message can also remove its embed afterwards.
Discordbot cannot load the page
Bot protection, a firewall or a country block that stops Discordbot means no embed. If the checker loads your page but Discord does not, allow user agents containing Discordbot.
The page has no Open Graph tags
Discord then falls back to the page title, or shows nothing. The issue list below the preview names exactly which tags are missing.
The image is not usable
A relative image URL, an image that returns an error, an SVG file or a very heavy file all leave the embed without a picture.
How to refresh Discord’s cached preview
Discord keeps the embed it built for a URL for a while, so posting the same link again can show the old title or image even after your page is fixed. There is no public tool to clear it.
To check a fix, post the URL with a harmless query string, such as https://example.com/page?v=2. Discord treats it as a new link and builds a fresh embed. Embeds on messages that were already posted do not change.
The best share image for Discord
Use a 1200 × 630 px JPG or PNG and add twitter:card = summary_large_image for the large layout. Keep the file to a few hundred kilobytes so it loads quickly in busy channels, and keep text away from the edges, because Discord scales the image down to fit the embed.
Discord preview questions
Check the preview on other apps
Every app reads the same Open Graph tags but shows them differently. The checker above previews all of them at once; these pages explain each app’s own rules.
Seeing the wrong image on every app? Our guide Link Preview Showing the Wrong Image? How to Clear the Cache on Every Platform covers the fixes in one place.
See your Discord preview before you share the link
Check the tags, test the image, and fix the preview in minutes. Free, no signup.
Check a URL