Skip to main content

Media Files

Your story can include photos, videos, voice messages, and video notes. Media files are managed through the Media page on the Developers Portal.

Supported Formats​

TypeFormatsUsed in script as
Photo.jpg, .jpeg[photo=file.jpg/]
Video.mp4[video=file.mp4/]
Voice.mp3[voice=file.mp3/]
Video note.mp4[video_note=file.mp4/]
Video Notes

For video notes (circles), it's recommended to use videos with a resolution of 640x640 pixels and a length of no more than 59 seconds.

Uploading Media​

  1. Write your script first, referencing media files by name (e.g., [photo=hero.jpg/])
  2. Navigate to the Media page of your project
  3. The page shows a list of all media files referenced in your script
  4. Click Upload and select the files from your computer
  5. Files are uploaded directly and matched by name
Important!
  • The total size of all media files must not exceed 50 MB
  • File names must match exactly what is referenced in your script
  • Only the supported formats listed above are accepted

How It Works​

When you reference a media file in your script:

[photo=mission_plan.jpg/]Here is the operation plan.

The parser detects that mission_plan.jpg is required. On the Media page, you'll see it in the list β€” either as uploaded (with a checkmark) or as missing (waiting for upload).

Media in the Debugger​

If your media files are uploaded, the debugger will show previews when hovering over media messages during testing.