<metaproperty="description"content="Telegram allows users to set an emoticon or a custom emoji as status, to show next to their name in chats and profiles.">
<metaproperty="og:title"content="Emoji status">
<metaproperty="og:image"content="">
<metaproperty="og:description"content="Telegram allows users to set an emoticon or a custom emoji as status, to show next to their name in chats and profiles.">
<p>Telegram allows users, channels and supergroups to set an emoticon or a <ahref="/api/custom-emoji">custom emoji</a> as status, to show next to their name in chats and profiles.</p>
<h3><aclass="anchor"href="#setting-an-emoji-status"id="setting-an-emoji-status"name="setting-an-emoji-status"><iclass="anchor-icon"></i></a>Setting an emoji status</h3>
<p>Use <ahref="/method/account.updateEmojiStatus">account.updateEmojiStatus</a> to change the status emoji of your profile. </p>
<ul>
<li>Pass <ahref="/constructor/emojiStatus">emojiStatus</a> to set a <ahref="/api/custom-emoji">custom emoji</a>.</li>
<li>Pass <ahref="/constructor/emojiStatusUntil">emojiStatusUntil</a> to set a <ahref="/api/custom-emoji">custom emoji</a>, for a limited period of time.</li>
<li>Pass <ahref="/constructor/emojiStatusEmpty">emojiStatusEmpty</a> to set the default Premium badge.</li>
</ul>
<p>The newly set <ahref="/type/EmojiStatus">EmojiStatus</a> constructor will be contained in the <code>emoji_status</code> field of the <ahref="/constructor/user">user</a> constructor, and other users will receive an <ahref="/constructor/updateUserEmojiStatus">updateUserEmojiStatus</a>. </p>
<p>Other logged-in clients will also receive an <ahref="/constructor/updateRecentEmojiStatuses">updateRecentEmojiStatuses</a> update, indicating that the recent status emoji list has changed. </p>
<p>Recently used emoji statuses can be fetched using <ahref="/method/account.getRecentEmojiStatuses">account.getRecentEmojiStatuses</a>, and the list can be cleared using <ahref="/method/account.clearRecentEmojiStatuses">account.clearRecentEmojiStatuses</a>. </p>
<p>Note that the custom emoji selection UI should offer a list of categories to quickly filter results by a (list of) emojis, or by some other criteria, see <ahref="/api/emoji-categories">here»</a> for more info. </p>
<h4><aclass="anchor"href="#setting-an-emoji-status-in-channels-and-supergroups"id="setting-an-emoji-status-in-channels-and-supergroups"name="setting-an-emoji-status-in-channels-and-supergroups"><iclass="anchor-icon"></i></a>Setting an emoji status in channels and supergroups</h4>
<p><strong>Only</strong> channel/supergroup custom emoji <ahref="/constructor/stickerSet">stickersets</a>, i.e. <ahref="/constructor/stickerSet">stickersets</a> with the <code>channel_emoji_status</code> flag set, can be used in channel/supergroup custom emoji statuses. </p>
<p>Note, however, that some specific <ahref="/api/custom-emoji">custom emojis</a> from channel/supergroup custom emoji stickersets cannot be used as channel/supergroup statuses: use <ahref="/method/account.getChannelRestrictedStatusEmojis">account.getChannelRestrictedStatusEmojis</a> to fetch the full list of IDs of custom emojis that cannot be used in channel/supergroup statuses.</p>
<p>Channels/supergroups gain the ability to change their status emoji only after reaching at least the <ahref="/api/boost">boost level</a> specified in the <ahref="/api/config#channel-emoji-status-level-min"><code>channel_emoji_status_level_min</code> »</a>/<ahref="/api/config#group-emoji-status-level-min"><code>group_emoji_status_level_min</code> »</a> config parameters. </p>
<h3><aclass="anchor"href="#featured-emoji-status-stickersets"id="featured-emoji-status-stickersets"name="featured-emoji-status-stickersets"><iclass="anchor-icon"></i></a>Featured emoji status stickersets</h3>
<p>A set of standard statuses for users/(channels/supergroups) can be fetched by passing <ahref="/constructor/inputStickerSetEmojiDefaultStatuses">inputStickerSetEmojiDefaultStatuses</a>/<ahref="/constructor/inputStickerSetEmojiChannelDefaultStatuses">inputStickerSetEmojiChannelDefaultStatuses</a> to <ahref="/method/messages.getStickerSet">messages.getStickerSet</a>, as specified in the <ahref="/api/stickers">stickerset documentation»</a>. </p>
<p><ahref="/method/account.getDefaultEmojiStatuses">account.getDefaultEmojiStatuses</a> can also be used to get a list of featured emoji statuses, from multiple featured custom emoji stickersets.<br>
<ahref="/method/account.getChannelDefaultEmojiStatuses">account.getChannelDefaultEmojiStatuses</a> is the equivalent method for channel/supergroup emoji statuses.</p></div>