Upload documents

Upload documents


Character Limitation

Please limit your item name to 120 characters. Uploading any items whose names exceed this limitation will result in their names cropped. This can be an issue if you have any pre-annotations or JSONs relying on the original filenames.

Attach document URLs

You can import documents to Text Projects by linking them from external storages. The linked documents are displayed in SuperAnnotate, but they aren't stored in our local servers. Learn more.


  • SuperAnnotate supports text files with UTF encoding only.
  • You can't upload more than 50,000 documents, whether it's in a project's root or a folder. The remaining documents will be skipped.

Integrations (AWS, GCP, Azure and Custom)

You can add documents to your Text Projects from your integrated cloud storage (AWS, GCP, Azure and Custom). SuperAnnotate will have read-only access to your data; your documents are stored in your cloud storage and are only displayed in SuperAnnotate.

Because files are not stored in our local servers during integration, you will need to enable CORS for your Text Projects to be imported successfully. Learn more.

Learn how to create integrations:

To add documents from your integrated cloud storage to SuperAnnotate:

  1. In Data, click Add.
  2. Select Upload Documents.
  3. In the Integrations tab, select an integration from the drop-down list.
  4. Type a folder path (optional).
  5. Click Upload.
  6. Refresh the page to see your added documents.

The bucket’s folder structure will be replicated in SuperAnnotate’s two-level folder structure.


What is a folder path?

A folder path indicates the folder that contains the items and subfolders you want to add to SuperAnnotate. So, if you type Folder A / Folder B, it means that the items will be added from Folder B, which is a sub-folder of Folder A. If you don’t type a folder path, the bucket’s items and folders (and the items inside) will be added from the root.

SDK function

To attach items from your integrated storage:

    project = "my_project_name",
    integration = "my_integration_name",
    folder_path = "data/folder_1"