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.
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> | 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> | tg://invoice?slug=<slug> | Invoice |
— | tg://settings | App 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
- Websites, emails, QR codes, social profiles — the
t.melink. It opens in every browser and falls back to a page with an Open button when the app is missing. - Buttons inside your own mobile or desktop app — the
tg://link. It skips the browser, but check first that Telegram is installed, otherwise nothing happens. - Audiences whose providers block t.me — a link on a backup domain. The path stays the same, only the domain changes.
Limits
- The converter checks the shape of a link, not whether the chat, post or invite behind it exists.
- The
#fragmentpart of a link is dropped: Telegram ignores it when it reads a deep link. - Rare formats — wallpapers, Telegram Passport, payment and gift flows — are in the official documentation and are not converted here.
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.