Attaching URLs is a useful way to import your items into your SuperAnnotate projects. You can import items by linking them from external storages. The linked items are displayed in SuperAnnotate, but they aren't stored on our local servers. There are a couple of methods that you can use to do this.

🚧
Item naming restrictions
When naming your items, please avoid using the following special characters as they’ll cause the item to be skipped during import: < > : ” ' / \ ? * & $ ! +

How to Attach URLs

You can attach URLs through the use of this Python SDK function: attach_items()

📘
Requirements
Please note that in order to attach the URLs, you'll need two keys for each item:

URL (Required)

Name (Optional)

If you don't provide a name for your URLs, it'll be provided an auto-generated UUID.

In order to attach items with a CSV file, you can create a file and store your data in the url and name columns accordingly, like so:

url	name
`https://sa-public-files.s3.us-west-2.amazonaws.com/My+project/example_item_1.json`	example_item_1
`https://sa-public-files.s3.us-west-2.amazonaws.com/My+project/example_item_2.json`	example_item_2
`https://sa-public-files.s3.us-west-2.amazonaws.com/My+project/example_item_3.json`	example_item_3

Once you've done that, you can pass its path to the attachments parameter:

sa.attach_items(
    project = "Project Name", 
    attachments = "./items.csv",
    annotation_status = "QualityCheck")