Telegram Bot API lets captions sit above photos and videos
What changed
Bot API 7.4 (May 28, 2024) added the show_caption_above_media parameter to sendAnimation, sendPhoto, sendVideo, copyMessage and editMessageCaption, and the matching field on InputMediaAnimation, InputMediaPhoto and InputMediaVideo. The same release added expandable_blockquote entities in MarkdownV2 and HTML, message effects (private chats only) and Telegram Stars payments with the XTR currency.
What it means
Posts sent by bots can show the caption above the photo, video or GIF instead of below it, and can use expandable quote blocks.
Who is affected
Tools that post photos, videos and GIFs with captions to Telegram channels and groups.
What to do by 28 May 2024
Optional. Pass show_caption_above_media: true on sendPhoto, sendVideo, sendAnimation, copyMessage, editMessageCaption or in InputMedia objects.
What this means for you
On Telegram, the words of a post usually sit under the picture. Now a tool can put the words on top instead. Long text can also go in a box that readers tap to open. These are layout choices, nothing you have to change.
The details
- Parameter:
show_caption_above_mediaonsendAnimation,sendPhoto,sendVideo,copyMessageandeditMessageCaption. - Fields:
show_caption_above_mediaonMessage,InputMediaAnimation,InputMediaPhoto,InputMediaVideoand the matching inline query result classes, so it also works inside albums sent withsendMediaGroup. - Formatting:
expandable_blockquoteentities can be parsed inMarkdownV2andHTMLparse modes or set explicitly in entities. - Effects:
message_effect_idwas added to the send methods; the API reference limits it to private chats, so it does not apply to channel posts. - Payments: the same release added Telegram Stars payments (currency
XTR);provider_tokenmust be omitted for Stars payments.
What to do next
- Business owners: Nothing.
- Marketers and agencies: If you want captions above images in Telegram, ask your scheduler whether it exposes the option.
- Developers: Add a
show_caption_above_mediatoggle to photo, video and GIF posts, and supportexpandable_blockquotein your formatter.
Primary sources
Get an email when a new API change is added
Follow new entries with the RSS feed. Each platform also has its own feed, for example X or Meta.