Getting listed
Submit your bot
Every listing is reviewed before it goes live. Verifying that you own the bot is optional, but it earns the owner badge and lets you manage the listing.
1. Submit the listing
Log in with Telegram and open Submit Bot. You'll need:
| Field | Notes |
|---|---|
| Telegram username | The bot's @username. It must be a real bot and not listed already. |
| Bot name | Up to 60 characters. |
| Category | Pick the one that fits best. |
| Supported languages | At least one. |
| Short description | One sentence, up to 120 characters. Shown on cards and in search. |
| Long description | Up to 1,000 characters: what it does, key commands, use cases. |
| Tags | Optional, up to 8. |
| Commands | Optional. Command name and a short description each. |
| Bot image | Optional. Resized automatically. |
You also confirm that you're allowed to list the bot and that the details are accurate. Listings that are inaccurate or misleading get rejected.
If the bot is already in the directory, you'll get a link to its listing instead. Claim it rather than submitting it again.
2. Verify ownership
Right after submitting, or later from your dashboard, you can prove you control the bot. Your bot sends a one-time code to our verifier bot; Telegram tells us which bot sent it, so it's the same proof as showing us the token, without the token leaving your hands.
- Press Get verification code. You get a code like
tglist-ABCD2345, valid for 15 minutes. - In @BotFather, open your bot's settings and turn on Bot-to-Bot Communication Mode.
- Have your bot send the code to
@tgl_official_bot. The simplest way is one request from your machine:
curl "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/sendMessage?chat_id=@tgl_official_bot&text=tglist-ABCD2345"The page updates on its own once the message arrives. If the code expires, get a new one.
Claiming a bot someone else listed
Anyone can suggest a bot, so yours may already be in the directory. Open Claim your bot, find it, and complete the same verification. The listing then moves to your dashboard. Official Telegram bots can't be claimed.
Listing statuses
Your dashboard shows where each listing stands. Click a status to see what it means and what to do next.
Start
In review
Live
Needs your action
Submitted — in review
Waiting for a moderator.
Next: Verify ownership while you wait, so it goes live with the owner badge.
The Telegram messages you get along the way are in Notifications.
After you're listed
Your listing page
Listings live at /bots/your-bot-username (underscores become hyphens). Link to it from your bot, for example in a /vote command, so users can find it and vote.
Votes and ranking
Logged-in users can upvote a bot once every 24 hours. Votes, reviews and usage feed the Top and Trending lists. To give users something back for voting, see Vote rewards.
Analytics
Each listing has an Analytics tab in the dashboard with page views, opens and votes over time.