Upload videos

Upload videos


Character Limitation

Please limit your item name to 120 characters. Uploading any items whose names exceed this limitation will result in their names cropped. This can be an issue if you have any pre-annotations or JSONs relying on the original filenames.

Supported video file formats

SuperAnnotate supports the following video file formats that HTML5 supports: OGG, WEBM, and MP4. Learn more about browser compatibility.

Upload from computer (Image Projects only)

To upload videos from your computer:

  1. In Data, click Add.
  2. Select Upload Video (with frames).
  3. Drag and drop or choose video files from your computer.
  4. Type a frame rate.
  5. Click Done.


Frame rate

Frame rate (fps) is the number of frames that appear per second. Under Frame rate (fps), type a number to break your videos into several frames or images. The higher the frame rate, the more images will appear per second, and vice versa. The default frame rate is 1.

CLI upload (Image Projects and Image (Legacy) Projects)

The CLI upload function is ideal for downloading a large batch of videos. Learn more.

Attach video URLs (Video Projects)

You can import videos to Video Projects by linking them from external storages. The linked videos are displayed in SuperAnnotate, but they aren't stored in our local servers. Learn more.

Integrations (AWS, GCP, Azure, and Custom)

You can add videos to your Video Projects from your integrated cloud storage. SuperAnnotate will have read-only access to your data; your items are stored in your cloud storage and are only displayed in SuperAnnotate.

Learn how to create integrations:

To add videos from your integrated cloud storage to SuperAnnotate:

  1. In Data, click Add.
  2. Select Upload Videos.
  3. In the Integrations tab, choose an integration from the drop-down list.
  4. Type a folder path (optional).
  5. Click Upload.
  6. Refresh the page to see your added videos.

The bucket’s folder structure will be replicated in SuperAnnotate’s two-level folder structure.


What is a folder path?

A folder path indicates the folder that contains the items and subfolders you want to add to SuperAnnotate. So, if you type Folder A / Folder B, it means that the items will be added from Folder B, which is a sub-folder of Folder A. If you don’t type a folder path, the bucket’s items and folders (and the items inside) will be added from the root.

SDK function

To attach items from your integrated storage:

    project = "my_project_name",
    integration = "my_integration_name",
    folder_path = "data/folder_1"

Maximum video file size

  • The maximum video file size for videos that are uploaded from the computer or via CLI is 5 GB. There are no resolution limitations.
  • There are no file size limitations for videos that are attached with URLs.