EN

Telegram deep links: t.me and tg:// formats

A Telegram deep link exists in two forms: a web link on t.me and an app link that starts with tg://. Paste either one to see what it opens and get the other form.

Try:

What tg://resolve?domain= means

tg://resolve?domain=durov is the app form of the link t.me/durov. tg:// is a URL scheme registered by the Telegram apps, resolve is the command “find this chat”, and domain carries the username. When you tap a t.me link in a browser, the page hands this tg:// address to the app — which is why it shows up in the address bar, in “Open in Telegram?” prompts and in error messages.

If such a link does not open, the device has no app that handles tg://: Telegram is not installed, or the link was opened in an in-app browser that blocks external schemes. Convert it to the t.me form above and open that — a web link works in any browser and offers to launch or install the app.

All link formats

The table follows the official Telegram documentation (core.telegram.org/api/links). Wherever t.me is written, telegram.me and telegram.dog are accepted too. A public username can also be written as a subdomain: username.t.me.

Web link (t.me)App link (tg://)What it opens
t.me/<username>tg://resolve?domain=<username>Public profile, channel, group or bot
t.me/<username>?text=<text>tg://resolve?domain=<username>&text=<text>The same chat with a pre-filled message
t.me/+<phone>tg://resolve?phone=<phone>Chat by phone number
t.me/+<hash>
t.me/joinchat/<hash>
tg://join?invite=<hash>Invitation to a private group or channel
t.me/<username>/<id>tg://resolve?domain=<username>&post=<id>A message in a public channel or group
t.me/<username>/<thread>/<id>tg://resolve?domain=<username>&post=<id>&thread=<thread>A message inside a forum topic or a comment thread
t.me/c/<channel>/<id>tg://privatepost?channel=<channel>&post=<id>A message in a private channel or group; opens only for its members
t.me/<bot>?start=<parameter>tg://resolve?domain=<bot>&start=<parameter>Bot with a start parameter
t.me/<bot>?startgroup=<parameter>tg://resolve?domain=<bot>&startgroup=<parameter>Add the bot to a group
t.me/<bot>?startapp=<parameter>tg://resolve?domain=<bot>&startapp=<parameter>The bot’s main mini app
t.me/<bot>/<app>?startapp=<parameter>tg://resolve?domain=<bot>&appname=<app>&startapp=<parameter>A named mini app of the bot
t.me/share/url?url=<url>&text=<text>tg://msg_url?url=<url>&text=<text>Share a link: the user chooses a chat
t.me/addlist/<slug>tg://addlist?slug=<slug>Chat folder
t.me/addstickers/<slug>tg://addstickers?set=<slug>Sticker set
t.me/addemoji/<slug>tg://addemoji?set=<slug>Custom emoji set
t.me/<username>/s/<story_id>tg://resolve?domain=<username>&story=<story_id>A story
t.me/boost/<username>tg://boost?domain=<username>Boost a channel
t.me/m/<slug>tg://message?slug=<slug>Business chat link
t.me/proxy?server=…&port=…&secret=…tg://proxy?server=…&port=…&secret=…MTProto proxy settings
t.me/socks?server=…&port=…tg://socks?server=…&port=…SOCKS5 proxy settings
t.me/addtheme/<name>tg://addtheme?slug=<name>Theme
t.me/setlanguage/<slug>tg://setlanguage?lang=<slug>Interface language pack
t.me/$<slug>
t.me/invoice/<slug>
tg://invoice?slug=<slug>Invoice
—tg://settingsApp settings; has no web form
—tg://user?id=<id>User by numeric ID; used by bots for mentions inside messages, not a link to publish

Parameters worth knowing

text
Pre-fills the message field in a chat by username or phone number. The value is percent-encoded UTF-8. A text that begins with @ gets a space in front, so that it does not trigger an inline bot.
profile
Opens the profile page of the user, channel or group instead of the chat.
start, startgroup
Pass a value to a bot: up to 64 characters from the base64url alphabet — Latin letters, digits, _ and -.
startapp
Opens the bot’s mini app and passes a value to it.
single
In a message link, shows one item of an album instead of the whole album.
comment, thread
Point to a comment under a channel post or to a message inside a topic.
t
A timestamp inside a video or audio message: the media starts from that second.

When to use which form

Limits

Questions

How do I convert tg://resolve?domain= to a normal link?

Take the value after domain= and put it after t.me/: tg://resolve?domain=durov becomes t.me/durov. If the link also has &post=123, the number goes after a slash: t.me/durov/123. The converter on this page does this for every link type.

Why does a tg:// link not open in my browser?

Browsers pass tg:// addresses to an installed app and cannot open them on their own. Without Telegram on the device, or inside an in-app browser that blocks external apps, nothing happens. Use the t.me form of the same link.

Is there a deep link to a user by ID?

Not one you can publish. tg://user?id=… exists so that bots can mention a user inside a message; it has no t.me form, and Telegram’s documentation tells regular apps to ignore it as a standalone link. A public link needs a username or a phone number.

More Telegram link tools

Link formats follow the official Telegram documentation. Checked on 15 November 2026.