Discord Embed Not Showing? Diagnose and Fix Your OG Tags
Table of Contents
You paste a link into Discord and nothing appears — no title, no image, no embed card. Or worse, the wrong image shows and the title is completely missing. Discord link embeds are notoriously inconsistent, but the most common cause is fixable: missing or malformed Open Graph tags on the linked page.
Our tool reads the same og: tags Discord reads and shows you exactly what is — and is not — present. Here is how to diagnose and fix Discord embed problems at the source.
Why Discord Link Embeds Fail — The OG Tag Layer
Discord reads Open Graph meta tags to build link embed cards. When you paste a URL into a Discord channel, Discord's backend fetches the page, reads the og:title, og:description, and og:image tags from the HTML head, and renders a card in the channel. If any of these are missing or broken, the embed is downgraded or does not appear at all.
The most common causes of Discord embed failure:
- og:image missing or broken — Discord requires a valid og:image to show the large embed card. Without it, no image appears and Discord may skip the embed entirely.
- og:image is not HTTPS — Discord blocks non-HTTPS image URLs. An og:image pointing to an HTTP URL will not render.
- og:title or og:description absent — Discord falls back to the HTML title tag, but og:title and og:description are required for a complete embed card.
- Page blocks Discord's bot — Some servers and CDNs block Discord's embed crawler (user agent: Discordbot). If the page returns an error to Discord's bot, no embed is generated even if your OG tags are perfect.
Note: Discord does not use twitter:card or twitter:image — it reads og: tags only. Fixing Twitter card issues will not fix Discord embeds.
How to Check Your OG Tags for Discord Embeds
The Open Graph Checker reads and validates the same og: tags that Discord reads. Use it to diagnose embed issues before troubleshooting further.
Step 1 — Get your page HTML
Open the URL that is not embedding in Discord. Press Ctrl+U (Windows) or Cmd+U (Mac) to view page source. Press Ctrl+A then Ctrl+C to copy the full source.
Step 2 — Run the checker
Paste the HTML into the Open Graph Checker and click Check Tags. The tool shows the status of every OG tag: present, missing, or flagged.
Step 3 — Fix what is missing or broken
Focus on three tags for Discord specifically:
- og:image — must be present and an HTTPS URL pointing to an actual image file. Open the image URL directly in a browser to confirm it returns a 200 status.
- og:title — should be set to the specific page title, not your site name.
- og:description — a short 2-3 sentence description. Discord displays this below the title in the embed card.
Force Discord to Refresh a Cached Embed
Discord caches link embeds aggressively. Even after you fix your OG tags, Discord may continue showing the old (broken) embed for hours. To force a refresh:
- Delete the message containing the broken embed from the Discord channel
- Paste the link again in a new message
This forces Discord to re-fetch the page and rebuild the embed from your current OG tags. If the embed still does not appear after re-pasting, the issue is not cache — it is either the OG tags still broken or Discord's bot being blocked from the page.
Check whether Discord can reach your page
If your site uses Cloudflare or similar proxy services with bot protection, Discord's Discordbot user agent may be getting blocked by security rules. Temporarily check your firewall or rate-limiting config to confirm Discord can fetch your page.
Recommended og:image dimensions for Discord
Discord renders og:image at a 16:9 ratio in large embed cards. A 1200x630 image (the standard OG image size) will display correctly in Discord channels with no cropping.
Discord vs Facebook and Twitter — Embed Behavior Differences
Not all platforms read OG tags the same way. Here is what makes Discord different:
| Platform | Uses og: tags? | Uses twitter:card? | Cache duration |
|---|---|---|---|
| Discord | Yes (og: only) | No | Several hours — delete and re-paste to clear |
| Yes | No | 30 days (use Sharing Debugger to clear) | |
| Twitter / X | Yes (og: + twitter:) | Yes | ~7 days |
| Yes | No | ~7 days (use Post Inspector to clear) | |
| Slack | Yes | No | Minutes to hours |
The key Discord-specific facts: no twitter:card support, og:image must be HTTPS, and cache clears when you delete the message and re-paste the link. Fix the og: layer first — everything else follows.
Try It Free — No Signup Required
Runs 100% in your browser. No data is collected, stored, or sent anywhere.
Open Free OG Tag CheckerFrequently Asked Questions
Why does my Discord link show a broken image or no image?
The most common cause is a missing or invalid og:image tag. Discord requires og:image to be present, pointing to an HTTPS image URL that returns a 200 status. Check your og:image with the Open Graph Checker — if it shows missing or flagged, that is your fix. Also ensure the image URL is absolute (starting with https://) and not a relative path.
Does Discord support twitter:card tags?
No. Discord ignores twitter:card and twitter:image entirely. It reads og:title, og:description, og:image, and og:url only. If you have been editing twitter: tags to fix a Discord embed issue, those changes will have no effect. Fix the og: tags instead.
My OG tags look correct but Discord still shows no embed — why?
Three possibilities: (1) Discord cached the old version — delete the message, re-paste the link to force a refresh; (2) Your server is blocking Discord's bot (Discordbot user agent) — check Cloudflare, Nginx, or hosting security rules; (3) Discord is rate-limiting the domain — rare, but can happen for new or very low-traffic domains. Try again after an hour.

