How Telegram Animated Gifts Work: Star Purchases, Profile Collections & Star Conversions
Celebrate milestones, holidays, and close friendships with verifiable digital prestige. Discover how Telegram Animated Gifts allow users to send limited-edition collectibles with customized personal notes—letting recipients display them on their public profile showcase or convert them back into Telegram Stars.
How Star Gifts Are Serialized in Layer 174
A technical breakdown of the MTProto data schema governing animated gifts and profile collections.
// Definition of an Animated Collectible Star Gift
starGift#cf633a6b flags:#
limited:flags.0?true
id:long
sticker:Document
stars:long
availability_remains:flags.0?int
availability_total:flags.0?int
convert_stars:long = StarGift;
// Sending a Star Gift to a Specific User
payments.sendStarGift#61ffec21 flags:#
hide_name:flags.0?true
user_id:InputUser
gift_id:long
message:flags.1?TextWithEntities = Updates;
// Converting a Received Gift to Account Stars
payments.convertStarGift#7ecd6478
stargift:InputSavedStarGift = Bool;
When sending a gift, the client calls payments.sendStarGift. If hide_name:true is passed, the server strips the sender's identity from public view, only revealing the sender's name in the recipient's private notification chat. The recipient receives a persistent SavedStarGift entity, which can either be toggled to pinned_to_top on the profile tab or redeemed for convert_stars via payments.convertStarGift.
Simulate sending an animated gift, choose privacy settings, and toggle between showcasing on profile or converting to Stars.
How to Send and Manage Telegram Gifts
Follow these simple actions on mobile or desktop.
•••) and choose Send a Gift. Browse through animated seasonal collectibles.
Animated Gifts FAQ
Answers regarding gift conversions, limited editions, and profile privacy.
