TSocial TSocial
Open in Telegram
Better in TelegramOpen in Telegram

Set Your Bot's Description, About Text, Commands and Photo

· 4 min read · 18+ readers

Set Your Bot's Description, About Text, Commands and Photo: TSocial guide cover card

The first thing a person sees about your bot icon bot is not code. It is the profile: a picture, a name, a short description and a command menu. This guide explains each element, where it appears and how to set it either in BotFather or through the Bot code icon API. Good profile text improves trust and reduces confusion.

The elements

ElementWhere it appears
NameChat header, search results
UsernameLinks, mentions
Profile photoChat list and header
DescriptionThe empty chat screen before Start, under "What can this bot do?"
Short description (About)The bot's profile page, and when the bot is shared
Description pictureAbove the description on the empty chat screen
CommandsThe menu opened by the slash button
Mock BotFather /mybots screen with a bot list and buttons for API Token, Edit Bot, Bot Settings, Payments and Transfer Ownership
/mybots opens a button menu for each bot. Labels can change over time. Generic illustration, not a real chat or user data.

In BotFather

  • /setname for the display name.
  • /setuserpic for the photo (upload a square image).
  • /setdescription for the longer description.
  • /setabouttext for the short About text.
  • /setdescriptionpic for the picture on the empty chat screen.
  • /setcommands for the menu list.

Choose the bot, then follow the prompts. See BotFather commands.

Through the Bot API

These methods exist in the Bot API. Check their current signatures in the documentation.

setMyName              { name, language_code? }
setMyDescription       { description, language_code? }
setMyShortDescription  { short_description, language_code? }
setMyCommands          { commands: [{command, description}], scope?, language_code? }
getMyCommands, deleteMyCommands, getMyName, getMyDescription, getMyShortDescription

An example call:

{
  "commands": [
    { "command": "start", "description": "Welcome" },
    { "command": "links", "description": "My links" },
    { "command": "help", "description": "How this bot works" }
  ]
}

Rules to remember: command names use lowercase letters, digits and underscores, are limited in length, and the description is short. The documentation lists the exact limits.

Languages and scopes

Both descriptions and commands accept a language_code. Telegram shows the version that matches the user's language and falls back to the default. This is helpful for international audiences. Commands also have scopes: you can show different menus in private chats, in groups and to group admins. Use scope for that, for example {"type":"all_private_chats"}.

Writing good text

Description (up to 512 characters):

  • First line: what the bot does in plain words.
  • Second: who it is for.
  • Third: how to start.
  • Mention 18+ where relevant.

Example: "Get my link icon links, ask a question or see what is new. Made by Mia for her followers. Tap Start to begin. 18+ only."

Short description (up to 120 characters): a single clear line. It also appears in some search and share previews.

Commands: short verbs in plain language. Avoid more than six or seven.

Photo: a simple, high contrast image that reads at a small size. A face or logo works well. Keep it safety icon safe for work, since the picture is public.

Limits can change, so check the documentation if text is rejected.

Keep it honest

  • Say that it is a bot.
  • Do not copy another brand's name or picture.
  • Do not claim features the bot does not have.
  • If AI writes replies, say so somewhere visible. See AI disclosure.

Consistency with your brand

Use the same name, colours and tone as your channel megaphone icon channel and website. See branding and domains.

Checklist

  • Name, username and photo set.
  • Description and short description written and proofread.
  • Commands registered, tested and sensible.
  • Language variants added if needed.
  • Profile checked from a second account.

Quick checklist

  • Name, username and a legible profile photo set.
  • Description under 512 characters that says what the bot does and for whom.
  • Short description under 120 characters.
  • Commands registered with short plain descriptions.
  • Language variants added where your audience needs them.
  • Command scopes set if groups need a different menu.
  • Everything checked from a second account.
  • Public text is safe for work and says it is a bot.

Keep it current

Your bot profile is a shop window, so review it whenever features change. Remove commands that no longer work, update links and check that the description still matches what the bot does. An out of date menu is one of the quickest ways to lose a new user's trust.

Frequently asked questions

Why does my description not show?

It appears on the empty chat screen before the first message. Users who already chatted will not see it again.

Why did my new commands not appear?

Telegram caches menus. Restart the app or reopen the chat. Check scope and language settings.

Can I use emoji?

Yes in descriptions, but use sparingly. Command names themselves must follow the allowed characters.

Can I change the username later?

It is restricted and breaks old links. Choose carefully.

Related guides

More in Build on Telegram

All topics: Build on Telegram · Guide index · Explore Telegram · About TSocial

Set Your Bot's Description, About Text, Commands and Photo | TSocial