Discord Embed & Link Preview Checker

Discord Link Preview Checker

See your link as a Discord embed, with the site name, colored side border and the image layout Discord would pick. We fetch the page as Discordbot and flag what breaks the embed.

How Discord builds a link embed

Discord turns links into embeds: a card with a colored bar on the left. Its crawler identifies as Mozilla/5.0 (compatible; Discordbot/2.0; +https://discordapp.com) and builds the embed from:

Site name: small text at the top, from og:site_name. Without it, nothing appears there.
Title, shown as a blue link, from og:title, then twitter:title, then <title>.
Description from og:description, with up to about 350 characters shown.
Image from og:image or twitter:image.
Border color from <meta name="theme-color">.

The image layout is controlled by twitter:card: with summary_large_image, the image fills the width of the embed under the text. Without it, Discord puts a small thumbnail in the top-right corner. That's the most common surprise when people first check their Discord embed.

Customizing your Discord embed

<meta property="og:site_name" content="Your brand">
<meta property="og:title" content="Page title">
<meta property="og:description" content="What the page is about.">
<meta property="og:image" content="https://example.com/og/page.jpg">
<meta name="twitter:card" content="summary_large_image">
<meta name="theme-color" content="#5865F2">

The theme-color tag is also used by mobile browsers to tint the address bar, so pick your brand color. Use a hex value: named colors and CSS variables aren't reliable.

Why a Discord embed doesn't show

Discordbot is blocked or too slow

Bot protection that challenges unknown visitors often catches Discordbot. Slow responses also lose the embed. The checker shows the status and response time Discordbot got.

JavaScript-only meta tags

Discordbot reads the raw HTML. Client-rendered apps need SSR or prerendering for the pages people share.

Permissions and settings

In a server channel, members need the Embed Links permission for their links to embed. Users can also turn off link previews in their own settings (Text & Images). If the checker shows a valid embed but your channel doesn't, check these first.

The link is in angle brackets

Writing a link as <https://example.com> deliberately suppresses the embed in Discord.

How to refresh a Discord embed

Discord caches embeds and has no public tool to clear them. After fixing the tags, wait for the cache to expire, or post the URL with an extra parameter such as ?v=2 to get a fresh fetch right away. Existing messages keep the embed they were posted with.

Frequently asked questions

Why doesn't my link show an embed in Discord?

Discordbot needs a fast 200 response with Open Graph tags in the HTML. Common blockers are Cloudflare bot protection, JavaScript-rendered tags and timeouts. Users also don't see embeds when they've turned off link previews in their settings, or lack the Embed Links permission in the channel.

How do I change the color of the Discord embed border?

Discord uses the page's theme-color meta tag for the left border: <meta name="theme-color" content="#5865F2">.

How do I get a large image in a Discord embed?

Add <meta name="twitter:card" content="summary_large_image">. Without it, Discord shows the image as a small thumbnail in the top-right corner.

Why is the site name missing above the title?

Discord shows og:site_name above the title. If it's missing, that line is blank.

How do I refresh a Discord embed?

Discord caches embeds for some time and has no public refresh tool. Post the URL with a parameter such as ?v=2 to get a fresh fetch.