Telegram Instant View: How It Works and How to Make a Template

Instant View is Telegram's built-in reader: when you share a link to a supported article, Telegram shows an Instant View button that opens a clean, fast version of the page inside the app. It works through templates, sets of rules written on Telegram's Instant View platform that tell Telegram where the title, text and images sit on a particular website. Anyone can write a template for any site, test it, and share links that use it, while Telegram decides which templates apply automatically to everyone.

This guide explains how Instant View looks to readers, why some links get the button and others do not, how templates work, and how to build, test and use one. It describes template rules in words rather than code. The reference is Telegram's Instant View manual and checklist on instantview.telegram.org, which you will have open while you build.

What readers see

When a link to a supported page appears in a chat or channel, the link preview shows an extra button labelled Instant View. Tapping it opens the article inside Telegram:

• The page loads almost immediately, because Telegram has already processed it on its servers.
• Text is laid out for the phone screen, without the site's menus, pop-ups, cookie banners or ads.
• Images, embedded videos, quotes and lists keep their place in the article.
• The reader can scroll, zoom images, and go back to the chat without opening a browser.

Telegram's own publishing tool, Telegraph, creates pages that always open in Instant View. For other sites, the button appears only when a template exists for that site and Telegram is using it.

Why Instant View matters to channel owners

If you run a channel that links to articles, Instant View changes how readers experience those links:

• Fewer lost readers. A slow mobile page or a cookie wall loses some readers before they see anything. Instant View removes both.
• Reading stays in Telegram. Readers finish the article and return to your channel in one tap, which suits the way people scroll channels.
• Consistent look. Articles from different sites look tidy and uniform in your feed.

There is a trade-off for website owners: an Instant View reader does not load your page, so your site's own analytics, ads and sign-up forms do not run. Some publishers welcome the reach; others prefer readers on their site. Decide which matters more for you before investing time in a template.

If your goal is simply to publish readable long posts for your channel, Telegraph may be all you need, with no template work at all. If you link to your own website a lot, a template can be worth it. For other ways of bringing web content into a channel, see our guides to auto-posting blog articles to Telegram and a Telegram channel RSS feed.

How Instant View works behind the scenes

Understanding the pipeline makes templates much easier to write and debug.

1. A link is shared. Telegram fetches the page to build the link preview.
2. Telegram looks for a template for that domain. Templates are matched to a website's domain.
3. The Instant View engine loads the page and applies the template's rules in order. Each rule finds elements on the page or changes them.
4. The result is converted into Instant View's own format, which supports a fixed set of building blocks: headings, paragraphs, images, videos, embedded posts, quotes, lists, tables and a few others.
5. If the template says this page is an article and the required pieces were found, an Instant View page is produced and the button appears. Otherwise, the link shows an ordinary preview.

Instant View pages are cached, so changes to a page or a template do not always show up immediately for everyone.

What a template is made of

A template is a short text file of rules, one per line, applied from top to bottom. Telegram's manual describes four kinds of rules. Here they are in plain terms.

Properties

Properties are the named pieces Instant View needs. The most important are:

• title: the article's headline. Required.
• body: the element containing the article's text and media. Required.
• subtitle or kicker: a standfirst under, or a section label above, the title.
• author and author_url: who wrote it, with an optional link.
• published_date: when it was published.
• cover: the main image or video at the top.
• description and image_url: what the link preview shows.
• channel: the Telegram username of the site's own channel, so readers can join it from the article.

A property rule says, in effect, "the title is the first element matching this location on the page". If a property already has a value, a later rule does not overwrite it unless you tell it to, which is how you write fallbacks: first try the precise location, then a more general one.

Locating elements: XPath

Rules point at parts of the page using XPath 1.0, a standard notation for describing a location in an HTML document, such as "the h1 inside the element whose class is article-header", or "every paragraph inside the main content". The manual adds a few conveniences, such as shortcuts for matching an element by class name. You do not need to be an expert, but you will spend most of your time writing and adjusting these location expressions.

Conditions

Conditions decide whether the template, or a group of rules, applies to the current page. The most useful one checks whether something exists. A typical template starts with a condition such as "this page has an article element", so that home pages, category pages and search results do not get an Instant View page. If no condition at the top passes, nothing is generated, which is exactly what you want for non-article pages.

Variables and functions

Variables hold a set of elements so you can work on them in several steps. Functions change the page before conversion. Common jobs include:

• Removing share buttons, "related articles" boxes, newsletter prompts and ads from inside the body.
• Turning a styled box that is really a quote into a proper quote block.
• Replacing a lazy-loaded image placeholder with the real image address stored in another attribute.
• Wrapping a caption and an image together so they display as a figure with a caption.
• Converting an element that shows an image as a CSS background into a real image.

Telegram's manual lists every function and what it does, with examples.

Before you start

1. A Telegram account, used to sign in to the Instant View platform.
2. A desktop browser. The editor is designed for a large screen.
3. A list of sample pages from the site: several normal articles, an article with a gallery, one with an embedded video, one with a long table or list, and some pages that are not articles, such as the home page and a category page.
4. Some familiarity with your browser's developer tools, so you can inspect a page and see the classes and structure of its elements.
5. Telegram's Instant View checklist, which sets out the quality rules a template must meet.

Step by step: building a template

1. Open the editor for the domain

1. Go to instantview.telegram.org and sign in with Telegram.
2. Open the editor and enter the address of one of your sample articles.
3. The editor shows three panels: the original page, your template rules, and the Instant View result.

2. Add a condition for article pages

Find something every article page has and other pages do not, such as an article element or a specific class on the headline. Add a condition at the top that requires it. Check the home page in the editor afterwards: it should produce no Instant View page.

3. Set the title and body

Inspect the headline and write a rule setting the title property to it. Then find the element that contains the article text, and set the body property to it. With just these two, the result panel should show a rough article. If it shows nothing, one of the two was not found; the editor highlights which.

4. Add the supporting properties

Add the author, the published date, a cover image if the site uses one at the top, and a subtitle if there is one. For the date, point at a machine-readable date on the page, such as the date in the article's metadata, rather than display text like "3 days ago".

5. Clean the body

Look through the result for anything that is not part of the article: share bars, author boxes repeated at the bottom, "read more" lists, newsletter forms, comment widgets. Add rules that remove them. Remove as narrowly as you can, targeting the specific element, so that you never delete real content by accident.

6. Fix media

Check every image, video and embedded post in the result. Common problems:

• Images missing because the site loads them lazily and the real address sits in a different attribute. Add a rule that copies it into place.
• Captions separated from their images. Group them into a figure.
• Embeds showing as empty boxes. Instant View supports many embed types, but the original markup sometimes needs reshaping first. The manual explains supported embeds.
• Decorative images, such as author avatars or icons inside the text, that should be removed.

7. Set the channel

If the site has a Telegram channel, set the channel property to its username. Readers then see a way to join from the article. If you run a Telegram channel for your website, this is a direct route from article readers to subscribers; see how to grow a Telegram channel for what to do with them.

8. Test on many pages

A template that works on one article often breaks on another. Open each sample page in the editor. Telegram's guidance suggests tracking changes on a wide range of pages, often ten to fifteen or more, before submitting. Check:

• Every normal article renders completely and in order.
• Galleries, videos, tables and quotes appear correctly.
• Non-article pages produce nothing.
• Nothing essential is missing anywhere.

9. Work through the checklist

Telegram's checklist is strict on one point in particular: if an essential part of an article cannot be shown in Instant View, for example an interactive chart that the format does not support, the template must not produce an Instant View page for that article. A partial article is worse than none, because readers would not know something is missing. Add a condition that skips such pages.

A template walk-through in words

Here is how a complete template for a simple, made-up blog might read, rule by rule, described in plain language. Each item below is one or two rules.

1. A condition: continue only if the page contains an article element whose class is post. Every other page stops here.
2. Set the title to the h1 inside that article.
3. Set the subtitle to the paragraph with the class standfirst, if there is one. If it is missing, nothing happens, which is fine for an optional property.
4. Set the author to the link inside the byline element, and the author link to that link's address.
5. Set the published date to the datetime value of the time element in the byline. As a fallback, a second rule sets it from the page's published-time metadata; because the property is already filled when the first rule works, the fallback only applies when it does not.
6. Set the cover to the first figure in the article header.
7. Set the body to the element with the class post-content.
8. Remove, from inside the body, the share bar, the newsletter box and the related-posts list, each targeted by its own class.
9. For every image in the body that has a lazy-load address attribute, copy that address into the standard image address.
10. Wrap each image and its following caption paragraph into a figure, so the caption stays attached.
11. Set the channel to the blog's Telegram username.

Eleven short steps cover a typical blog. A news site with live blogs, galleries and sponsored sections needs more, but the shape is the same: condition, required properties, optional properties, clean-up, media fixes.

Using your template

Sharing links that use your template

Each template has its own identifier, called an rhash. The editor lets you generate links in the form of a t.me Instant View link containing the article's address and your template's rhash. When you post such a link, Telegram users see an Instant View page built with your template, even before Telegram has approved it for the domain.

This is the practical route for channel owners: if you run your own site, you can post rhash links to your articles in your channel and readers get Instant View immediately. Bear in mind that a template bug will show in every link that uses it, so test before using it in a busy channel.

Getting a template used automatically

For ordinary links to a site to show the Instant View button automatically, Telegram must approve a template for that domain. Telegram ran public contests in the past in which people submitted templates for review. How and when templates are reviewed and approved now is decided by Telegram and is not guaranteed for any particular site. If you submit one, follow the platform's current instructions, and keep using rhash links meanwhile.

Keeping a template working

Templates break when sites change, and nobody tells you. A little routine prevents a channel full of broken articles.

1. Check a recent article in the editor every month or two, and after any redesign you hear about.
2. Write fallbacks for the two required properties. If the title or body cannot be found, no page is produced at all, so one renamed class can switch Instant View off for the whole site.
3. Prefer stable hooks. Article and time elements, and metadata, change less often than visual class names.
4. Keep notes next to unusual rules, explaining which page type they are for. The editor allows comments in templates, and future you will need them.
5. Retest your sample pages after every change, not just the page you were fixing.

Instant View and your channel's numbers

Readers who open an article in Instant View do not load your website, so your site analytics see nothing. Your channel still shows how many views the post itself received, which Telegram counts when people see the post in the channel. Our guide to Telegram channel statistics explains what those numbers mean.

If you need to know how many people actually read an article, you have to accept less precise data with Instant View, or post plain links to your site instead. Some channel owners use Instant View for most posts and a direct link when a post needs a sign-up or a purchase on the site.

When the button shows and when it does not

Even with a working template, readers do not always see Instant View. Knowing why saves a lot of confused debugging.

• The link preview was removed. Instant View lives in the link preview. If the person posting removes the preview before sending, there is no button. In a channel, check that previews are on when you post.
• The link is not the first one in the message. A message with several links usually shows one preview. Put the link you want previewed where Telegram picks it up, and check the draft before sending.
• The page is behind a login or paywall. The engine fetches the page as a visitor would. Content that needs an account is not there to convert. Do not try to work around a paywall with a template; it is not your content to unlock.
• The page needs scripts to show its text. Some sites deliver an empty shell and fill it in with scripts. Instant View works on the delivered page, so there may be nothing to convert.
• The preview was cached earlier. If the link was shared before the template existed, the old preview may be reused for a while.

What Instant View cannot show

The Instant View format supports a fixed set of building blocks. Content outside that set cannot be represented, and the checklist says an essential part that cannot be shown means no Instant View page at all. Typical examples:

• Interactive charts, maps and calculators.
• Forms, quizzes and polls built into the page.
• Comment sections, which are not part of the article anyway.
• Custom players for audio or video that do not use a supported embed.
• Layouts where meaning depends on position, such as side-by-side comparisons that make no sense in a single column.

When you meet one of these, decide whether it is essential. A decorative widget can be removed. A chart that the article's argument depends on means that page should be skipped with a condition.

Making your own website Instant View friendly

If you control the website, you can make templates simpler and sturdier by changing the site rather than the template.

1. Wrap each article in a clear container, such as a single article element, with the headline and body inside.
2. Use real headings in order, not styled paragraphs pretending to be headings.
3. Put the real image address in the standard attribute, even if you also lazy-load, so the address is present when the page is fetched.
4. Mark up the author and publication date in standard metadata, which also helps search engines.
5. Keep promotional blocks outside the article container, so they are never part of the body.
6. Keep class names stable. A redesign that renames everything breaks every template at once.

These same habits make your site easier to read for search engines and accessibility tools, so they are rarely wasted effort.

Troubleshooting

No Instant View button appears

How to recognise it: a link to a page shows an ordinary preview without the button.

1. Check whether a template exists and is approved for that domain. If you only have your own unapproved template, you need an rhash link.
2. If you used an rhash link, check that the address inside it is correct and that the template produces a result for that page in the editor.
3. Check your conditions: the page may be failing the "is this an article" condition.

If the editor shows a correct result but the chat does not, the preview may be cached. Try with a different article.

The page shows but text is missing

How to recognise it: the Instant View page has a title but parts of the article are absent.

1. Open the page in the editor and compare the original with the result.
2. Look for a removal rule that is too broad, catching real content.
3. Check whether the missing content is loaded by scripts after the page loads; the engine works on the page as fetched, so content injected later may not be there. On your own site, render the article text in the page itself.

Images do not appear

How to recognise it: grey boxes or gaps where images should be.

1. Inspect the image element on the original page and find where the real address is stored.
2. Add a rule copying that address into the image's standard attribute.
3. If the image is a CSS background, use the function that turns backgrounds into images.

The template worked, then stopped

How to recognise it: links that used to show Instant View no longer do, or show broken pages.

The site's layout probably changed. Open a current article in the editor, find which properties are no longer found, and update their locations. Build fallbacks into your rules, so one class name change does not break everything.

Example

This is an illustrative scenario. A small cooking website runs a Telegram channel that posts every new recipe. Recipes load slowly on mobile, and many readers never finish them. The owner builds a template: a condition requiring the recipe container, the title from the recipe headline, the body from the recipe content, the cover from the hero photo, and removal rules for the printable-card button and newsletter box. Ingredient lists render as lists, and the step photos as images with captions. Pages with an interactive serving-size calculator are excluded by a condition, because the calculator cannot be shown. The owner posts rhash links in the channel, and readers now open recipes inside Telegram in one tap.

What to do next

• If you only post other people's articles, you do not need a template. Check which of the sites you share most already show the Instant View button, and prefer linking to those versions where you have a choice.
• If you run a website and a channel, start with your most common page type, usually the standard article, and build a template for that alone. Add galleries and special formats later.
• If you write long posts but have no website, try Telegraph for your next one and compare how readers respond with your usual format.
• If you are about to redesign your site, keep the article container and its key classes stable, or plan a template update on the same day as the launch.
• Whatever you choose, keep a short list of sample pages and retest them whenever something changes. It is the cheapest insurance against a feed of broken articles.

Common mistakes

• No article condition, so home pages and category pages get broken Instant View pages.
• Testing on one article only.
• Broad removal rules that delete real paragraphs on some pages.
• Ignoring lazy-loaded images, leaving gaps.
• Producing Instant View for articles with unsupported essential content, which the checklist forbids.
• Assuming a submitted template applies automatically before Telegram has approved it.
• Relying on fragile class names without fallbacks.

FAQ

Do I need permission from a website to write a template for it?

Anyone can write a template for any site on the Instant View platform. Whether it is used automatically is Telegram's decision.

Does Instant View count as a visit to my website?

The reader sees your content without loading your page, so your site's own analytics and ads do not run for that view.

Can I make Instant View pages without a website?

Yes. Telegraph pages always open in Instant View and need no template, which makes them the simplest option for long channel posts.

Can I turn Instant View off for my site?

You can design your pages so templates find nothing, but whether Telegram shows Instant View for a domain is ultimately controlled by Telegram's templates. Contact Telegram through its official support routes if you have a specific concern; see how to contact Telegram support.

Does Instant View work on Telegram Desktop?

Yes, Instant View pages open in Telegram's apps on phones and computers, though the layout adapts to each screen.

Summary

Instant View turns a supported web article into a fast, clean reader inside Telegram. It is driven by templates: ordered rules that locate the title, body and media with XPath, remove clutter, and refuse to build a page when something essential cannot be shown. Build and test a template on Telegram's Instant View platform across many pages, use rhash links to share it straight away, and make your own site's markup clean so templates stay reliable. For channel posts that do not need a website at all, Telegraph gives you Instant View with no template. Whichever route you take, test on real pages before your readers do.