Upload images

Upload images

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

Supported image file formats

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

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 Done.


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, and Azure)

You can add images to your Image Projects from your integrated cloud storages (AWS, GCP, and Azure). 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 (this step if for Image Projects and Image (Legacy) Projects that don't have items only).
  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.

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 by linking them from external storages. The linked images are displayed in SuperAnnotate, but they aren't stored on our local servers. Learn more here.

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].