Skip to content

UploadFieldFile

UploadFieldFile = object

Defined in: packages/ui/src/types.ts:867

Per-file upload state tracked internally by UploadFieldProps.

Each entry corresponds to a file the user selected (or dropped) into the field. Once a file finishes uploading successfully its key is appended to the controlled value array and the entry can be removed from this tracker. Failed uploads stay in the tracker so the user can see (and dismiss) the error inline without losing previously uploaded files.

optional error: string

Defined in: packages/ui/src/types.ts:883

Inline error message if status === "error".


id: string

Defined in: packages/ui/src/types.ts:869

Stable id for React keying / tracking across renders.


optional key: string

Defined in: packages/ui/src/types.ts:881

Server-side R2 key, only set after a successful upload.


name: string

Defined in: packages/ui/src/types.ts:871

Display name (taken from File.name).


progress: number

Defined in: packages/ui/src/types.ts:877

Current upload progress as a 0-100 percentage.


size: number

Defined in: packages/ui/src/types.ts:873

File size in bytes.


status: "pending" | "uploading" | "success" | "error"

Defined in: packages/ui/src/types.ts:879

Lifecycle status.


type: string

Defined in: packages/ui/src/types.ts:875

MIME type as reported by the browser.