<metaproperty="description"content="Telegram users can make it easy for others to contact them or find their public groups and channels via usernames: clients can also assign multiple collectible usernames to accounts, supergroups and channels they own.">
<metaproperty="og:description"content="Telegram users can make it easy for others to contact them or find their public groups and channels via usernames: clients can also assign multiple collectible usernames to accounts, supergroups and channels they own.">
<p>Telegram users can make it easy for others to contact them or find their public groups and channels via <ahref="https://telegram.org/faq#usernames-and-t-me">usernames</a>: clients can also assign multiple <strong>collectible usernames</strong> to accounts, supergroups and channels they own. </p>
<p>Collectible usernames work just like basic <ahref="https://t.me/username">@usernames</a>, they appear in Global Search results and have <ahref="/api/links#public-username-links">deep links »</a>, just like basic usernames. </p>
<p>The ownership of collectible usernames is secured by TON, a fast and scalable blockchain network. They can be bought and sold through the <ahref="https://fragment.com">Fragment platform »</a>, giving a simple and secure way to acquire and exchange valuable Telegram domains. </p>
<p>On the Fragment platform, clients may associate or dissociate purchased collectible usernames either to their Telegram account, or to a bot/channel/supergroup they own. </p>
<p>If any collectible username is associated to an account, channel or supergroup, <ahref="/constructor/user">user</a>.<code>username</code> and <ahref="/constructor/channel">channel</a>.<code>username</code> won't be set, and <ahref="/constructor/user">user</a>.<code>usernames</code> and <ahref="/constructor/channel">channel</a>.<code>usernames</code> will be set, instead: these fields contain an array of <ahref="/constructor/username">username</a> constructors, which indicate whether a certain username is a basic username (<code>editable</code> is set) or a collectible username (<code>editable</code> is not set); and whether a collectible username is <code>active</code> or not.<br>
The first username in the <code>usernames</code> vector must be shown in-UI as the main username.</p>
<p>Immediately after association, a username is marked as not <code>active</code> (i.e. only the owner can see it in the <code>usernames</code> list): use <ahref="/method/account.toggleUsername">account.toggleUsername</a>, <ahref="/method/bots.toggleUsername">bots.toggleUsername</a> or <ahref="/method/channels.toggleUsername">channels.toggleUsername</a> to mark it as active.<br>
Note that you can't mark as inactive the basic (non-collectible) username, if any. </p>
<p><ahref="/method/channels.deactivateAllUsernames">channels.deactivateAllUsernames</a> may also be used to mark as inactive all collectible usernames associated to a certain supergroup or channel: useful for example when making a group or channel private, by first invoking <ahref="/method/channels.updateUsername">channels.updateUsername</a> with an empty username to remove the editable username (if present), and then invoking this method to remove all associated collectible usernames. </p>
<p>Use <ahref="/method/account.reorderUsernames">account.reorderUsernames</a>/<ahref="/method/bots.reorderUsernames">bots.reorderUsernames</a>/<ahref="/method/channels.reorderUsernames">channels.reorderUsernames</a> to change the order of the usernames associated to an account, channel or supergroup: all currently active usernames must be specified.</p></div>
</div>
</div>
</div>
<divclass="footer_wrap">
<divclass="footer_columns_wrap footer_desktop">
<divclass="footer_column footer_column_telegram">
<h5>Telegram</h5>
<divclass="footer_telegram_description"></div>
Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.
