How to import

Explore various import methods on the Supervisely Platform, including importing different formats and modalities, importing from the cloud or via Ecosystem apps.

This 5-minute tutorial is a part of introduction to Supervisely series. You can complete them one-by-one, in random order, or jump to the rest of the documentation at any moment.

Supported formats and modalities

Image Datasets
  • Images in any directory structure without annotations.

  • Supported image formats: .jpg, .jpeg, jpe, .bmp, .png, .webp, .mpo, .tiff, .nrrd, .jfif, .avif, .heic.

Video Datasets
  • Auto-detect annotations in Supervisely, DAVIS (coming soon), MOT (coming soon) formats.

  • Videos in any directory structure without annotations.

  • Supported video formats: .avi, .mov, .wmv, .webm, .3gp, .mp4, .flv. ⚠️ All videos will be converted to .mp4 format during import.

Point Cloud Datasets
  • Point clouds in any directory structure without annotations in PCD, LAS, LAZ, PLY formats.

Point Cloud Episode Datasets
  • Auto-detect annotations in Supervisely format.

  • Point cloud episodes without annotations in PCD format.

Volume Datasets
  • Volumes in any directory structure without annotations in DICOM, NRRD formats.

You can always use applications to import different formats and modalities from our Ecosystem:

Import Images | Import Videos | Import Pointclouds | Import Pointcloud Episodes | Import DICOM Volumes | Import COCO Keypoints | Import Volumes in Supervisely format | Import KITTI-360 | Import Multispectral Images | and many other formats.

🪄 Here we will look at the fastest and easiest import option!


Let's start our journey with Supervisely by uploading our very first image. Of course, like we said before, you can import more complex dataset formats like COCO, or modalities, such as DICOM, connect a S3 cloud and much more, but let’s begin with a simple one.

We assume that you have already created an account in Supervisely. If not, you can create a free account in our Community Edition here.

First thing you will see after you login to Supervisely, is your Projects page where you can find your data. But there is nothing here yet — let’s fix that!

  1. Click the Import Data button. Enter a unique name for the project, keeping in mind that it must be unique in the workspace and case-sensitive. You can also add a description of the project to provide additional information or to track project updates.

  2. Next, select the Project type by defining the content modality: images, videos, point clouds, or DICOM 3D volumes.

  1. Choose one of the available interfaces for labeling images (or other data modality). Our interfaces are designed for different industries and annotation scenarios.

  2. After completing all required fields and selecting options, click Create to complete the project and begin uploading data.

  1. In the modal window, drag and drop one or more images in one of the supported formats, such as .jpg, .jpeg, .mpo, .bmp, .png, .webp, .tiff, .tif, .nrrd, .jfif, .avif, .heic, NIfTI, DICOM . You can also check out the supported annotation formats.

🤗 Congratulations, the hardest part is over!

You will be redirected to the Tasks page where you can watch the progress of the application (your files are actually being uploaded to your Team Files).

You can click three dots (⋮) icon and check the application logs.

Once the import is finished, you will see the link to your new project in the Output column of the table.

All set! Now, in the next section, let’s annotate your uploaded images.

Last updated

Was this helpful?