> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# File upload

> The File upload allows the user to upload files either by dragging and dropping files into the upload field or clicking to open the local system’s finder, allowing users to select and upload files from their computer or device.

## File upload

<Badge color="orange">In progress</Badge> | *Storybook link coming soon*

### When to use

* When users need to submit documents, images, or other media.
* In forms or workflows that require file attachments (e.g., profile pictures, reports, invoices).
* When multiple files need to be uploaded efficiently and with clear feedback.

### When to use something else

* When an alternative method (e.g., selecting from a gallery, embedding links) is more efficient.
* For small text-based input: use an [Input](/aura-design-system/primitives/input) instead (e.g., entering a URL instead of uploading a document).
* If users will frequently reuse files, consider providing a file repository instead of requiring uploads each time.
* When real-time document collaboration is needed, opt for embedded editors instead.

### Behavior

* Multi-file upload: If allowing multiple files to be uploaded, a list of uploaded files will appear below the File upload area. This ensures the user can still add more files later or remove specific files that are no longer needed.
* Single-file upload: If only one file is allowed to be uploaded, the File upload area is replaced by the uploaded file. This removes the possibility for the user to add additional files unless they remove the uploaded one.

### Often used with

* [Label](/aura-design-system/primitives/label), [Helper text](/aura-design-system/primitives/helper-text); file list with remove actions; [Progress](/aura-design-system/primitives/progress) or inline status during upload.