Import items

There are a few ways you can import items into your project, whether it’s by uploading them or generating them manually.

Integration or SDK

Add an item to the SuperAnnotate platform using one of the following methods:

• Import data with cloud integrations
• Import data with Python SDK

Each data item should be a valid JSON file. A key advantage here is that you can specify your own schema and modify the values in the UI builder or in the code editor.

Example

Let’s assume we have a JSON file imported from an AWS S3 bucket using the cloud integration method.

JSON file:

{
    "metadata":
        {
            "name": "My conversation",
            "category": "Cooking",
            "image_url": "https://your_bucket.s3.us-west-2.amazonaws.com/data/conversation.json"
        }
}

Let’s assume you want to display the name and category values as paragraphs on the UI. To do this, you simply need to add the {{metadata.name}} and {{metadata.category}} expressions in the component configuration field, as it is shown below:

For cases that include a data item that should be signed as an integration item, you need to use a specific function: {{sign(metadata.image_url)}}

Upload items

You can upload items to your project through an integration, or by attaching URL. These items must follow the same format as that project's form template. You can view this structure in a downloaded item's annotation JSON.

To upload items through an integration:

1. In the Data tab, click + Add.
2. Select Upload Items.
3. Select an integration from the dropdown, and a location path (if applicable).
4. Click Upload

Upload CSV

You can import items into your project by uploading a CSV.

To upload a CSV:

1. In the project, click + Add.
2. Click Upload CSV.
3. In the pop-up, drag and drop your CSV file or choose a file from your computer.
4. Click Upload.

❗️

Limitations

1. There are any invalid or non-existent component IDs in your CSV.
2. Your upload exceeds the folder’s 50,000 item limit.
3. Your upload exceeds your organization’s subscription plan limit.

CSV Format

Once your project’s form is created, you can download the CSV in order to use it for the data upload. You can download your CSV file in one of the following ways.

From the upload menu:

1. In the project, click + Add.
2. Click Upload CSV.
3. Select Annotation CSV form.

From the project’s form builder:

1. In the project’s form builder, click Export.
2. Select CSV for annotations.

When creating the CSV file for an LLMs and GenAI project, there are a number of factors to consider.

Your CSV file should only contain the following mandatory columns:

• Name - This is what the item's name will be in the Data tab. Items with missing values in this column will be provided a randomly generated UUID name.
• [Component ID] - This header’s value must be a component ID mentioned in your project’s form builder, e.g. Input_component_1. The ID must belong to an Input, Select, or Media component types that hasn’t been excluded from export.

Formatting

The CSV files required for an LLMs and GenAI project have to be created with the following in mind:

• Values in the CSV file must be separated by comma (,).
• If the value itself contains a comma, then you must write the value in quotation marks.
• Empty rows that contain no values or delimiters will be skipped.
• Each row of the CSV file will be uploaded into the platform as an individual item.
• For the Checkbox component, the options in the CSV file should be provided as a list of strings, as shown below:
  • ["Partially complete, needs review", "Incomplete"]
• For the Range slider component, the values in the CSV file should be provided as a list of integers (float), as shown below:
  • [2,5]

📘

Important conditions

• Any Single- or Multi-select values that don’t exist in the project will be skipped during the upload.
• If a component ID is included without any values under it, then all of the component’s values will be blank when uploaded.
• In case of any duplicate item names in the CSV file, only the first item with that name will be uploaded.
• Item names must be unique. If you try to upload items whose names already exist in the project, then these items won’t be uploaded.
• If there are any values in your CSV that belong to Select component options that don’t exist in the project, then those values won’t be uploaded.

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.

Item generation

Add an item to the SuperAnnotate platform using item generation. In this case, you will need to input data manually from the code editor.