Skip to content

Telegram link preview tester

Paste a URL and see the preview card Telegram will render when somebody shares it. We fetch the page with Telegram's same crawler user-agent and parse the Open Graph / Twitter Card / standard meta tags the same way it does.

Common pitfall: Telegram caches previews for ~12h. If you just updated your meta tags, add a cache-buster query param (?v=2) when sharing.

What Telegram looks for, in order

  1. Title:

    og:title → twitter:title → <title>

  2. Description:

    og:description → twitter:description → <meta name="description">

  3. Image:

    og:image → twitter:image (must be reachable over HTTPS, <5MB, ideally 1200×630)

  4. Site name:

    og:site_name → hostname

Image gotchas

  • Telegram requires an absolute HTTPS URL. Relative paths are silently ignored.
  • Minimum 200×200 to render; ideal aspect ratio 1.91:1 (1200×630).
  • If the image is behind hotlink protection or auth, Telegram falls back to a text-only card.
  • WebP and AVIF work on modern clients; older Android still prefers JPEG/PNG.

Forcing a re-crawl

Telegram aggressively caches link previews. Three ways to force a refresh:

  • Add a unique query string (?v=2, ?r=1), the URL is a different cache key.
  • Send the URL to @WebpageBot, official re-crawl trigger.
  • Wait ~12 hours and Telegram refreshes on its own.