Discord link embed preview

Discord Embed Checker

Paste a public URL to preview the embed Discord builds for it: the site name, title, description, image and the coloured edge. The checker reads the same tags Discord does and explains why an embed is missing or wrong.

Try: a GitHub repo · a page with no tags 10 checks left today

Preview

An approximation of each app’s layout. Apps change their designs and crop images differently.

What to fix

Refresh a cached preview

These results show your page as it is right now. An app that already saw the link may keep showing its older, cached preview until it fetches the page again:

  • Facebook & Messenger: open Meta’s Sharing Debugger, paste the URL and press Scrape Again.
  • LinkedIn: paste the URL into LinkedIn’s Post Inspector to fetch it again.
  • Telegram: send the URL to @WebpageBot in Telegram to update its stored preview.
  • WhatsApp, Discord, Slack & iMessage: there is no public refresh tool. Share the URL with a harmless query string added, such as ?v=2, so it counts as a new link.
  • X: start a new post with the link to see the current card; existing posts keep the card they were published with.

Tags found

Suggested tags

A complete set based on what we found. Replace any placeholder values, then paste it into the page’s <head>, or into your CMS or SEO plugin’s social settings.


          
        

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 URL

Why 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

Discord shows the image full width only when the page has <meta name="twitter:card" content="summary_large_image">. Without it, the og:image appears as a small thumbnail beside the text.

Add <meta name="theme-color" content="#5865F2"> to the page head, using any hex colour. Discord uses it for the strip down the left side of the embed.

Discord caches the embed it built for that URL. Your page is fixed if this checker shows the new tags. To see the new embed straight away, post the URL with ?v=2 added.

No. A bot or webhook builds its embed from the data it sends to Discord. Open Graph tags only control the embed Discord creates for a plain link pasted into chat.

Wrap it in angle brackets, like <https://example.com>, or remove the embed from your message after posting it.

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