File upload box

The Upload Box tool allows you to add an option for users to upload one file. The file is uploaded to a storage integration of your choice (e.g. AWS S3, GCP, etc.)

How to add an Upload Box tool to a project

From your project's Settings tab, enter the Category Schema section. Click on Add category, then pick Upload box. An Upload box tool will appear in your ontology:

Please note that each upload box only allows for the uploading of a single file per task per user. If you need to collect more files per task, you must add multiple upload boxes. (or, you may have users upload a single .zip archive containing the files requested)

Upload Box Settings

Setting name
Description

Title

The upload box's title. This text will appear immediately above the upload box itself.

Required

Whether or not the user is required to upload a file to this box before submitting the task.

Data storage

By clicking on Pick folder, you're able to select the storage integration (e.g. AWS S3, GCP, Azure) and, optionally, the subfolder within that integration where the file will be uploaded. Please note: Ango Hub must have write permissions to the bucket you are pointing to. See our page on storages for more.

Accepted Formats

You may optionally list here the file extensions you'd like to accept for this upload box. For example, .jpg and .png. If you leave it blank, any file will be accepted.

Filename

If you fill in this field, the file uploaded by the user will be renamed to this. You may use the placeholder {taskId} to include the current task's ID in the filename.

How a user can upload a file on the upload box

When the user is in the task, they will see the upload box as a classification.

They can simply drag and drop the file they wish to upload on the upload box, or they can click on the box to open their OS's file picker.

Last updated