Upload images

Upload images

You can upload images to Image Projects and Image (Legacy) Projects only.


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 image file formats

SuperAnnotate supports the following image file formats: JPG, JPEG, PNG, WEBP, TIFF, BMP, and TIF.

TIFF and TIF are only supported through direct uploads.

Maximum image file size and resolution

Project typeMaximum image file sizeMaximum image resolution
Image Project100 MB100 MP
Image (Legacy) Project100 MB4 MP

Upload from computer

To upload images from your computer:

  1. In Data, click Add.
  2. Select Upload Images.
  3. Drag and drop or choose files from your computer.
  4. Click Upload.


You can upload up to 2,000 images at a time. We recommend you upload up to 1,000 images at a time for a faster and smoother performance.

You can see the number of Uploaded, Skipped, and Failed images.

An image has the Skipped status if:

  • It has an existing name.
  • Its resolution exceeds 100 MP for Image Projects and 4 MP for Image (Legacy) Projects .

An image has the Failed status if:

  • Its size exceeds 100 MB for Image Projects and Image (Legacy) Projects.
  • SuperAnnotate doesn't support its file format.

SDK function

To upload images from a local folder:

    project = "Project Name",
    folder_path = "./data/images")

To upload images to a folder in a project:

    project = "Project Name/Folder Name",
    folder_path = "./data/images")


The syntax of project and folder paths is used across all SDK functions.

To set the annotation status of the images you want to upload:

    project = "Project Name",
    folder_path = "./data/images",
    annotation_status = "QualityCheck")

To enable recursive subfolder upload (when the images are stored in multiple subfolders):

    project = "Project Name",
    folder_path = "./data/images",
    annotation_status = "QualityCheck", 
    recursive_subfolders = True)


  • This function returns lists of uploaded, skipped, and failed to upload image names.
  • Images with existing names will be skipped (not uploaded).

To upload a predefined list of image paths:

    project = "Project Name",
    img_paths = ["./data/images/1.png", "./data/images/100.png"],
    annotation_status = "QualityCheck")

Import from S3 bucket

To import images from your S3 bucket:

  1. In Data, click Add.
  2. Select Upload Images.
  3. Go to the Import from S3 Bucket tab.
  4. Fill in the following fields: access key ID, secret access key, bucket name, and folder name. The folder name is optional.
  5. Click Test to see whether you have access to the S3 bucket or not.
  6. If you have access to the S3 bucket, click Start.


If the image upload limit has been reached, the exceeding images won't be uploaded.

Integrations (AWS, GCP, Azure and Custom)

You can add images to your Image Projects from your integrated cloud storages (AWS, GCP, Azure and Custom). 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 images from your integrated cloud storage to SuperAnnotate:

  1. Go to Data.
  2. Click Add.
  3. Select Upload Images.
  4. Go to the External storage tab (Image Projects and Image (Legacy) Projects must be empty or newly created for this tab to show as an option).
  5. In the Integrations tab, select an integration from the drop-down list.
  6. Enter a folder path (optional).
  7. Click Upload.

The storage’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.


External storage

Once you upload items using external storage, other direct upload options will be unavailable.

SDK function

To attach items from an integrated storage:

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

Attach image URLs

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

Upload multilayered images (Beta feature)

You can upload multilayered images to Image Projects. A multilayered image is an image that consists of multiple layers. Think of it as several images combined into one image.

Why do I need to work with multilayered images?

You might need to work with multilayered images when you need several references of the same image to achieve higher annotation accuracy. This is applicable for annotating aerial and satellite imagery. For instance, you can upload an image consisting of 3 layers: SAR (synthetic aperture radar imagery), IR (infrared satellite imagery), and RGB.

How does it work?

When you work on one layer, the changes will be applied to the other layers as well. So if you add annotations or comments on one layer, the annotations and comments will also appear on the other layers.

Want to learn more? Email our Support Team at [email protected].