Move items to folder

To move items to a folder:

1. In Explore or the Data tab, select the folder you want to move items from.
2. Select one or multiple items.
3. On the floating bar, click on Move/Copy to Folder.
4. Select Move to Folder.
5. From the Folder dropdown, select the destination folder.
6. Choose what to do in case the destination folder has items with the same name:
   • Skip: The items will not be moved to the new folder.
   • Replace: Any existing items with the same names will be replaced with the new ones, including their assignments, annotations, and all other data.
   • Replace only annotations: Only the annotations will be replaced. The rest of the existing item’s data will remain unchanged.
7. Click Move.

📘

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, Category, 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.
• 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.

🚧

Limitations

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

Copy items to folder

To copy items to a folder:

1. In Explore or the Data tab, select the folder you want to copy items from.
2. Select one or multiple items.
3. On the floating bar, click on Move/Copy to Folder.
4. Select Copy to Folder.
5. From the Folder dropdown, select the destination folder.
6. Choose whether you want to Include annotations and statuses in the copied items (optional). If you leave this box unchecked, skip step 6.
7. Choose what to do in case the destination folder has items with the same name:
   • Skip: The items will not be copied to the new folder.
   • Replace: Any existing items with the same names will be replaced with the new ones, including their assignments and annotations.
   • Replace only annotations: Only the annotations will be replaced. The rest of the existing item’s data will remain unchanged.
8. 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, Approval State, and Category.

🚧

Limitations

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

Add/Remove category

Through Explore, you can add categories to items in bulk. If you don’t have any categories, you can create one in this manner. This feature must be enabled for the project in order to use it. Learn more.

To add a category to your items:

1. Select one or multiple items.
2. On the floating bar, click Categorize.
3. Click Add Category.
4. Select an existing category from the dropdown list, or type in a name to create a new one.
5. Click Save.

You can also create new categories without adding them to any items right away and manage your categories from the project settings.

📘

To replace an item’s category, you can simply follow these steps again and add a new one.

🚧

Category Limitations

• Each item can only have one category at a time.
• A project can only have 2000 categories maximum.
• The character limit for a category name is 200.
• When choosing a name for your category, make sure it is unique and keep in mind that category names are case-insensitive. This means that ‘name’ and ‘Name’ will be considered the same.

To remove a category from your items:

1. Select one or multiple categorized items.
2. On the floating bar, click Categorize.
3. Click Remove Category.
4. In the pop-up, click Remove.

Find Items

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

Sort documents

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

📘

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

Filter items

In Data, you can filter your items by Approval state, Annotation status, Category, and Assignee:

1. Click on the Filter button beside the search bar.
2. Pick one or multiple filters from the following categories:
   • Approval state (multi-select): Approved, Disapproved, No Approval.
   • Annotation status: Any, Not started, In progress, Quality Check, Returned, Completed, Skipped.
   • Category: No Category, and any category that exists in the project.

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.

Delete items

To delete one or multiple items:

1. In Data, select one or multiple items.
2. Click Delete on the floating bar.
3. Click Delete.

🚧

Only Team Owners, Team Admins, and Project Admins (with permission) can delete items in bulk.

Download items

You can download your project in two ways: from the Downloads tab in FineTune, or by clicking Download on the floating bar in Explore.

🚧

About CSV exports

The SuperAnnotate CSV format export is only supported for components whose values are a string or number, as CSV files don’t support complex data types.

From FineTune

To download your project:

1. Go to the Downloads tab.
2. Click Prepare Download.
3. Select a format: SuperAnnotate JSON, SuperAnnotate JSONL, or SuperAnnotate CSV.
4. In the pop-up, type in a name.
5. Select the folders you want to include in your download.
6. Select one or multiple statuses to filter which items to include in your download.
7. If you’ve selected the SuperAnnotate CSV format, and you’d like to include the update and creation timestamps for instances in your exported CSV file, check the corresponding box.
8. Once you’re done, click Prepare.
9. After the download is prepared, click Download. You can cancel the preparation stage by clicking Cancel instead.

From Explore

1. When in your project, go to Explore.
2. Select the items whose annotation data you want to download.
3. Click Download on the floating bar.
4. Select a format: Download JSON or Download CSV.
5. Find the download being prepared in the Downloads tab in FineTune.
6. When the annotation files are ready, click Download.

Download annotation CSV

You can download your project’s annotations in CSV format from the project’s Downloads tab. You can choose to download the whole project or specify parts of it. The exported CSV file will follow the exact same format, and it will only include components of the Input, Select, and Media types that haven’t been excluded from export.

📘

Projects Admins (with download permission) and users with higher roles will be able to download the _item_category and _folder in the SuperAnnotate CSV format.

With SDK

You can also prepare your download with the following SDK functions: prepare_export() and download_export()

Examples

client = SAClient()

export = client.prepare_export(
    project = "Project Name",
    folder_names = ["Folder 1", "Folder 2"],
    annotation_statuses = ["Completed","QualityCheck"])


client.download_export("Project Name", export, "path_to_download")

client = SAClient()

export = client.prepare_export(
    project = "Project Name",
    folder_names = ["Folder 1", "Folder 2"],
    annotation_statuses = ["Completed","QualityCheck"],
    export_type = "CSV")

client.download_export("Project Name", export, "path_to_download")