Image Handling

Image sizes, formats, and display behavior for Telegram link previews

Recommended dimensions

1200 x 630 pixels at 1.91:1. Minimum 600 x 315 pixels. Images below 200 x 200 pixels may be rejected and won’t appear.

Large image vs. small thumbnail

The twitter:card tag controls the layout:

  • summary_large_image: full-width image above the text
  • summary or absent: small thumbnail to the right of the text

Without summary_large_image, even a perfectly sized 1200x630 image gets compressed into a small square thumbnail:

<meta name="twitter:card" content="summary_large_image">

Size limits

  • Minimum: 200 x 200 pixels
  • Maximum file size: 5 MB

Stay well under 5 MB. Large images slow down preview generation and can cause timeouts.

Supported formats

  • JPEG: photographs and complex images
  • PNG: graphics, logos, and images with text
  • WebP: supported, generally smaller file sizes
  • GIF: automatically converted to MPEG4 video and autoplays as a looping animation

If you want a static image, don’t use GIF. Use JPEG, PNG, or WebP.

Image URL requirements

  • Absolute URL with full scheme (https://example.com/image.jpg)
  • Accessible without authentication or cookies
  • HTTPS recommended (HTTP also works)
  • No JavaScript-dependent redirects

Relative paths like /images/og.jpg won’t resolve.