Manage images

Move images

1. In the Data tab or in Explore, select one or multiple images.
2. Click Move/Copy to Folder on the floating bar.
3. Click Move to Folder.
4. Choose the destination folder.
5. Click Move.

When you move an item from one folder to another, the item's annotation time is displayed in the Analytics tab of the previous folder. Learn more.

📘

About Moving

• Moving items to a different location will transfer with it the following item information: Item Status, Annotation, Assignee, Priority Score, Approval State, Pin State, Custom Metadata, and the item’s corresponding Working hours in Analytics.
• The items that you move will only retain their assignments if the assignees have access to the destination folder.

🚧

Limitations

• You can't move folders.
• Images with existing names will be skipped and will remain in their source folder.
• Images that exceed the folder limit won't be moved.

SDK function

To move images from one folder to another:

sa.move_images(
    source_project = "Project Name/Source Folder",
    image_names = ["image1.png", "image2.png"],
    destination_project = "Project Name/Destination Folder")

Copy images

1. In the Data tab or in Explore, select one or multiple images.
2. Click Move/Copy to Folder on the floating bar.
3. Click Copy to Folder.
4. Choose the destination folder.
5. Check the Include item data box if you want to copy the images with their item data included, as listed below (optional).
6. Click Copy.

📘

About Copying

When Include annotations and statuses is checked, copying items to a different location will transfer with it the following item information: Item Status, Annotation, Priority Score, and Approval State.

🚧

Limitations

• You can't copy images and folders at the same time.
• Images with existing names will be skipped.
• Images that exceed the folder limit won't be copied.

SDK function

To copy images between folders in a project:

sa.copy_images(
    source_project = "Project Name/Source Folder",
    image_names = ["image1.png", "image2.png"],
    destination_project = "Project Name/Destination Folder")

The image annotations and corresponding metadata are copied to the destination project by default. To disable this:

sa.copy_images(
    source_project = "Project Name/Source Folder",
    image_names = ["image1.png", "image2.png"],
    destination_project = "Project Name/Destination Folder",
    include_annotations = False,  
    copy_pin = False)

Sort images

In Data, you can click on Name, Status, or Priority to sort all images in ascending ^ or descending v order.

📘

Status is sorted by: Not started, In progress, Returned, Quality Check, Completed, and Skipped.

Find image

To find an image, go to Data and type the image name in the search bar.

SDK function

To get a project’s list of images:

superannotate.search_items(project = "Project Name")

To get the list of images whose names contain a specific word, such as car:

superannotate.search_items(
  project="Project 1", 
  name_contains="car")

To search for items whose names contain a specific word, such as car, and have a specific annotation status, such as InProgress:

superannotate.search_items(
  project="Project 1", 
  name_contains="car",
  annotation_status="InProgress")

📘

The annotation_status field can have one of the following values: NotStarted, InProgress, QualityCheck, Returned, Completed, and Skipped.

Filter images

In Data, you can filter your images by Pin state, Approval state, Annotation status, and Assignee:

1. Click on the Filter button beside the search bar.
2. Pick one or multiple filters from the following categories:
   • Pin state: All, Pinned, Not pinned.
   • Approval state (multi-select): Approved, Disapproved, No Approval.
   • Annotation status: Any, Not started, In progress, Quality Check, Returned, Completed, Skipped.

To filter by Assignee, you can click on the assignee's avatar (or icon) next to the search bar.

📘

• Filters from all categories can be applied at the same time.
• To clear filters, you can click on your selections again to remove them, or simply click Reset Filters.