Discord Open Graph Debugger
How Discord link previews actually work.
Discord does not provide an official Open Graph debugger.
However, you can use our OG tags tester to check your Open Graph tags and render a preview how Discord will render your URL.
If your link preview looks wrong in Discord, the issue is almost always caching or invalid Open Graph tags.
How Discord Reads Open Graph Tags
When a link is posted, Discord:
- fetches the URL from its servers
- reads
og:title,og:description,og:image - generates an embed preview
- caches the result
If OG tags are missing, Discord falls back to basic HTML metadata or guesses.
Which OG Tags Matter Most
Discord primarily uses:
og:titleog:descriptionog:image
Broken or missing og:image usually means:
- no preview
- text-only preview
- incorrect image
Why Discord Previews Don’t Update
The most common reasons:
- Discord cached the preview
- the image URL didn’t change
- the image isn’t publicly accessible
- the image loads too slowly or returns the wrong content-type
Reposting the same URL often shows the old preview.
How to Force Discord to Refresh a Preview
Since there’s no debugger, use these workarounds:
1. Change the Page URL
https://example.com/page?v=2
Discord treats it as a new link.
2. Change the og:image URL
og-image.png → og-image-v2.png
This reliably forces a refresh.
How to Debug Discord OG Issues
Best approach:
- validate OG tags with a neutral Open Graph checker
- confirm tags exist in the initial HTML
- verify
og:imageloads publicly in an incognito browser - then post a new URL in Discord
If it works elsewhere, Discord will usually follow.
Final Takeaway
Discord has no Open Graph debugger—only behavior.
Assume previews are cached forever, version URLs deliberately, and Discord embeds become predictable instead of frustrating.