Skip to content
Schedule Social Media

Press Esc to close.

New feature Telegram Severity: low

Telegram Bot API lets captions sit above photos and videos

Announced28 May 2024
Effective28 May 2024
StatusIn effect

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_media on sendAnimation, sendPhoto, sendVideo, copyMessage and editMessageCaption.
  • Fields: show_caption_above_media on Message, InputMediaAnimation, InputMediaPhoto, InputMediaVideo and the matching inline query result classes, so it also works inside albums sent with sendMediaGroup.
  • Formatting: expandable_blockquote entities can be parsed in MarkdownV2 and HTML parse modes or set explicitly in entities.
  • Effects: message_effect_id was 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_token must 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_media toggle to photo, video and GIF posts, and support expandable_blockquote in your formatter.

Primary sources

Checked against the source 7 Nov 2026

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.