← All posts

Discord Open Graph Debugger

How Discord link previews actually work.

Dmytro Krasun

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:

  1. fetches the URL from its servers
  2. reads og:title, og:description, og:image
  3. generates an embed preview
  4. 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:title
  • og:description
  • og: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:image loads 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.