File upload

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

​

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 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, Helper text; file list with remove actions; Progress or inline status during upload.