I like updates that make a tool feel lighter instead of heavier. This one from Telegram is exactly that: your bot's message can now contain a small interactive piece, and nobody has to leave the chat to use it.
The update is called Bot API 10.4, and it came out on November 9, 2026. The headline feature is widgets.
What is a Telegram widget?
A widget is a small block of interface, built with HTML, CSS and JavaScript, that sits inside a bot's message. You tap it, it reacts, and it can update right there in the bubble. Telegram's own example is an FAQ where the answers expand when you tap a question. No new page, no extra window.
That's the difference from a classic Mini App. A Mini App opens a bigger screen. A widget stays in the conversation, closer to a button that can do a bit more than a normal button.
How does it work?
- A bot sends the widget with a new method called
sendWidget. - The widget runs on your device and doesn't get direct internet access.
- When you tap something, the widget can send a small request to the bot through Telegram.
- The bot answers, and the same message updates with the new content.
Because it uses native rendering, it's supposed to feel smooth, not like a web page squeezed into a bubble.
The limits you should know
Widgets are meant to be small, and Telegram made that official. The compressed code is capped at 4 KB, and each widget can be up to 32 KB before compression. Anything bigger or more complex should stay a normal bot flow or a full Mini App.
Right now widgets can only be sent to private chats in the production environment. Widgets for groups and forwarded messages are still on Telegram's test server. Widgets that are sent are also protected, which means they can't be forwarded.
What can you build with it?
These are ideas, not things Telegram promised, but they fit the size limit well:
- An FAQ or help menu that expands inside the message.
- A small poll, a checklist or a counter.
- A live indicator, like the status of an order or a download.
- A quick form with a few fields, instead of a long back-and-forth of questions.
If you already have a Telegram bot, this could replace a stack of buttons and text replies with one clean message. The same release also adds hidden replies to button presses that only the person who tapped can see, plus a few smaller changes.
What about tools for developers?
The ecosystem is already moving. Go developers using the go-telegram/bot library can use version 1.28.0 to send widgets, and community projects are starting to appear, like a UI kit for the 4 KB limit. Some of those are marked early-stage by their authors, so expect rough edges for a while. The widget format also has quirks across iOS, Android and Desktop that people are still finding.
My take
I like this because the limit is the point. A widget that has to fit in 4 KB forces you to keep things simple, and simple tools are the ones people actually finish building. I'd start with something tiny, like a help menu, and see how it feels before planning anything bigger.
I'll update this post when widgets reach group chats.
FAQ
When did Telegram add widgets?
With Bot API 10.4, released on November 9, 2026.
Do widgets work in group chats?
Not yet in production. Groups and forwarded messages are still on Telegram's test server.
How big can a widget be?
4 KB compressed, and up to 32 KB of code before compression.
Do I need to build a Mini App for this?
No. Widgets are lighter and live inside the message. For bigger interfaces, a Mini App is still the better tool.