sodcalculator

10 Tech How-To

Telegram Link Preview: Large Image Guide

Guide 10-20608 · Updated · Step by step

This guide shows you how to make a link preview in Telegram display a large, eye-catching image instead of a small thumbnail or no image at all. You’ll learn the exact steps to configure your website’s meta tags, test the preview, and fix common issues so your links look professional in chats and channels.

What You’ll Need

  • Access to the HTML source code of the webpage you want to share (or ability to edit it via a CMS/website builder).
  • An image file hosted at a public URL (e.g., on your server or a CDN). The image should be at least 300×200 pixels, but larger (like 1200×630) works best.
  • A Telegram account (mobile or desktop app) to test the preview.
  • Optional: a URL shortener or link preview bot for testing without sending a message.

Step-by-Step

  1. Prepare your image. Choose an image that represents the content well. Telegram recommends images with a 1.91:1 aspect ratio (e.g., 1200×630 pixels) for large previews. Ensure the file is in JPG or PNG format and is publicly accessible via a direct URL (no login required).
  2. Add the Open Graph meta tags to your page’s <head> section. The most important ones for Telegram are:
    <meta property="og:title" content="Your Page Title">
    <meta property="og:description" content="A short description of your page.">
    <meta property="og:image" content="https://example.com/image.jpg">
    <meta property="og:url" content="https://example.com/page">
    <meta property="og:type" content="website">

    The og:image URL must be absolute (starting with https://), not relative.

  3. Add the Twitter Card meta tags (optional but recommended). Telegram also reads these if Open Graph is missing, but it’s best to include both:
    <meta name="twitter:card" content="summary_large_image">
    <meta name="twitter:title" content="Your Page Title">
    <meta name="twitter:description" content="Your description.">
    <meta name="twitter:image" content="https://example.com/image.jpg">

    The twitter:card value summary_large_image explicitly asks for a large image preview.

  4. Save your changes and upload the file. If you’re editing a static HTML file, upload it to your web server. If you’re using a CMS (like WordPress), use an SEO plugin or theme options to add these meta tags.
  5. Test the preview in Telegram. Send the link in any chat (you can use “Saved Messages” for a private test). Wait a few seconds for the preview to load. If it doesn’t appear, try sending the message again or use the “Preview” feature in the message box (on desktop, click the link icon).
  6. If the old preview is cached, force a refresh. Telegram caches link previews. To get a fresh one, append a query string to the URL (e.g., ?v=2) and send that. Alternatively, use the @WebpageBot in Telegram: send your link to the bot and it will show you the current preview and allow you to refresh it.
  7. Verify the image is accessible. Open the image URL directly in a browser. If it loads, it’s accessible. Also check that the server doesn’t block Telegram’s crawler (user agent TelegramBot).

Common Mistakes

  • Using a relative image path (e.g., /images/pic.jpg) instead of an absolute URL. Telegram can’t resolve relative paths.
  • Image too small or wrong aspect ratio. If the image is under 300×200, Telegram may show a small thumbnail or no image. Stick to 1200×630 for best results.
  • Forgetting the og:title or og:description. Without them, Telegram might use the page’s <title> and meta description, which may not be set correctly.
  • Blocking bots via robots.txt or .htaccess. If your server blocks the TelegramBot user agent, the preview won’t load.
  • Using an image that requires cookies or authentication. Telegram’s crawler won’t log in, so the image must be publicly accessible.
  • Editing the wrong file. If you’re using a CMS, the meta tags might be in a template file, not the page content itself.

Tips

  • Use a unique, descriptive title and description—they appear alongside the image and affect click-through.
  • Keep the image file size under 5 MB to ensure fast loading.
  • If you change the image later, update the og:image URL with a new filename or query parameter to bust Telegram’s cache.
  • Test with both the mobile and desktop Telegram apps—they may handle previews slightly differently.
  • For dynamic pages (e.g., product pages), generate the meta tags server-side based on the content, so each page has its own unique preview.

Troubleshooting

No preview at all: First, check that the page is publicly accessible and that the meta tags are in the <head> section (not in the body). Use the @WebpageBot to see what Telegram sees. If the bot shows no tags, your HTML might have syntax errors or the tags are added via JavaScript—Telegram doesn’t execute JavaScript.

Small image instead of large: Make sure og:image is set and the image dimensions are at least 300×200. Also, verify that twitter:card is summary_large_image—some sites only set Open Graph, and Telegram might fall back to a small card if the image is not large enough.

Old image still showing: Telegram caches previews aggressively. Append a query string to the URL (e.g., ?refresh=123) and send that. Or use @WebpageBot to request a refresh.

Image loads in browser but not in Telegram: Check your server logs for requests from Telegram’s crawler. If you see 403 or 404 errors, the bot is being blocked. Also, ensure the image URL is HTTPS—Telegram may ignore HTTP URLs in some cases.

Preview works on desktop but not mobile: This can happen if your server is slow or the image is too large. Optimize the image and ensure your server responds quickly.

Frequently Asked Questions

Does Telegram support Open Graph or Twitter Cards?

Telegram primarily uses Open Graph tags, but it also reads Twitter Card meta tags as a fallback. Including both is a good practice.

What is the ideal image size for a Telegram link preview?

For a large image, use at least 300×200 pixels, but 1200×630 (1.91:1 ratio) is recommended for consistent appearance across devices.

Why does my preview show a small image even though I set og:image?

This usually happens when the image is too small or Telegram has cached an older version. Try a larger image and refresh the cache.

Can I force Telegram to refresh the link preview?

Yes, append a query string to the URL (e.g., ?v=2) or use the @WebpageBot to request a refresh. The bot will also show you the current cached preview.

Do I need a special server setup for Telegram previews?

No, but your server must be publicly accessible and not block Telegram’s crawler. Also, the image must be served over HTTPS for best compatibility.

Will the preview work if my page uses JavaScript to load content?

No, Telegram’s crawler does not execute JavaScript. All meta tags and the image must be present in the raw HTML response.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →