Platform Fields & Media
Every Telegram platformSpecificData field and the image and video requirements.
Media requirements
Files above these limits are compressed automatically: images above 10 MB and videos above 50 MB. These are Telegram's own Bot API caps.
Compression has a ceiling of its own. A video over 200 MB is passed through untouched, and Telegram then refuses it.
Images
| Property | Requirement |
|---|---|
| Max per album | 10 |
| Formats | JPEG, PNG, GIF, WebP |
| Max file size | 10 MB (auto-compressed) |
| Max resolution | Width plus height must total 10,000 px or less; a larger image is downscaled |
Videos
| Property | Requirement |
|---|---|
| Max per album | 10 |
| Formats | MP4, MOV |
| Max file size | 50 MB (auto-compressed) |
| Max duration | No limit |
| Codec | H.264 recommended |
Media URLs must be direct HTTPS URLs, publicly accessible, with no redirects.
Telegram rejects HTTP URLs and redirecting links with "Wrong file identifier/HTTP URL specified". Upload files through the media endpoint to get a URL that qualifies.
Platform fields
All fields go in platformSpecificData on the Telegram entry.
| Field | Type | Default | Description |
|---|---|---|---|
parseMode | "HTML", "Markdown", "MarkdownV2" | "HTML" | How Telegram parses content. See Formatting. |
disableWebPagePreview | boolean | false | No link preview for URLs in the message. |
disableNotification | boolean | false | Deliver silently: recipients get the message without a notification sound. |
protectContent | boolean | false | Recipients cannot forward or save the message. |
Was this page helpful?