# 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](https://docs.imerit.net/data/storages) of your choice (e.g. AWS S3, GCP, etc.)

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FQpUbR2Z92A1M1PIBvQXs%2Fimage.png?alt=media&#x26;token=0d94a52c-f67f-4dec-be72-9b10ba4cac3a" alt=""><figcaption></figcaption></figure>

## 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:

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FN2qhm3YMrXkH3Kr4PPDo%2Floreshot-20260311-123640%402x.png?alt=media&#x26;token=b525c11a-cd2a-46f8-96d5-432fc3556d0e" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="159.57421875">Setting name</th><th>Description</th></tr></thead><tbody><tr><td><strong>Title</strong></td><td>The upload box's title. This text will appear immediately above the upload box itself.</td></tr><tr><td><strong>Required</strong></td><td>Whether or not the user is required to upload a file to this box before submitting the task.</td></tr><tr><td><strong>Data storage</strong></td><td>By clicking on <em>Pick folder</em>, you're able to select the <a href="../../../data/storages">storage integration</a> (e.g. AWS S3, GCP, Azure) and, optionally, the subfolder within that integration where the file will be uploaded.<br><br>Please note: Ango Hub <strong>must</strong> have <strong>write permissions</strong> to the bucket you are pointing to. See our page on <a href="../../../data/storages">storages</a> for more.</td></tr><tr><td><strong>Accepted Formats</strong></td><td>You may optionally list here the file extensions you'd like to accept for this upload box. For example, <code>.jpg</code> and <code>.png</code>. If you leave it blank, any file will be accepted.</td></tr><tr><td><strong>Filename</strong></td><td>If you fill in this field, the file uploaded by the user will be renamed to this.<br>You may use the placeholder <code>{taskId}</code> to include the current task's ID in the filename.</td></tr></tbody></table>

## 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.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FAxTCZ5lQHzQJiaVfDph5%2Floreshot-20260311-124816%402x.png?alt=media&#x26;token=bb0a5c09-2c47-4a30-8dd9-1aec0a12bc8b" alt=""><figcaption></figcaption></figure>
