--- title: UploadProps description: "Learn how to build custom functionality when working with the React Upload by Kendo UI with the help of the UploadProps." api_reference: true type: inner_api slug: api_upload_uploadprops --- # UploadProps Represents the props of the [KendoReact Upload component](https://www.telerik.com/kendo-react-ui/components/upload).
| Name | Type | Default | Description |
|---|---|---|---|
| #### accept? |
string
|
Sets the `accept` attribute of the file input element to specify allowed file types.
Example:
```jsx
|
|
| #### actionsLayout? |
[UploadActionsLayout]({% slug api_upload_uploadactionslayout %})
|
"end"
|
Specifies the layout of the action buttons. Defaults to `end`.
```jsx
|
| #### ariaDescribedBy? |
string
|
Identifies elements that describe the Upload component, similar to the `aria-describedby` attribute.
Example:
```jsx
|
|
| #### ariaLabelledBy? |
string
|
Identifies elements that label the Upload component, similar to the `aria-labelledby` attribute.
Example:
```jsx
|
|
| #### autoUpload? |
boolean
|
By default, the selected files are immediately uploaded. To change this behavior, set `autoUpload` to `false`. | |
| #### batch? |
boolean
|
When enabled, all files in the selection are uploaded in one request. Any files that are selected one after the other are uploaded in separate requests. | |
| #### className? |
string
|
Adds a custom CSS class to the Upload container element.
Example:
```jsx
|
|
| #### defaultFiles? |
[UploadFileInfo]({% slug api_upload_uploadfileinfo %})[]
|
Provides the initial list of files to be displayed in uncontrolled mode.
Example:
```jsx
|
|
| #### disabled? |
boolean
|
false
|
Disables the Upload component. Defaults to `false`.
```jsx
|
| #### files? |
[UploadFileInfo]({% slug api_upload_uploadfileinfo %})[]
|
Provides the list of files to be displayed in controlled mode.
Example:
```jsx
|
|
| #### id? |
string
|
Specifies the `id` attribute of the Upload component.
Example:
```jsx
|
|
| #### listItemUI? |
React.ComponentType<[UploadListItemProps]({% slug api_upload_uploadlistitemprops %})>
|
Customizes the rendering of list items in the file list.
Example:
```jsx
|
|
| #### multiple? |
boolean
|
true
|
Enables or disables the selection of multiple files. Defaults to `true`.
```jsx
|
| #### onAdd? |
(event: [UploadOnAddEvent]({% slug api_upload_uploadonaddevent %})) => void
|
Triggered when new files are selected for upload.
Example:
```jsx
|
|
| #### onBeforeRemove? |
(event: [UploadOnBeforeRemoveEvent]({% slug api_upload_uploadonbeforeremoveevent %})) => void
|
Triggered before a file removal request is made. Can be used to add extra data to the request.
Example:
```jsx
|
|
| #### onBeforeUpload? |
(event: [UploadOnBeforeUploadEvent]({% slug api_upload_uploadonbeforeuploadevent %})) => void
|
Triggered before a file upload request is made. Can be used to add extra data to the request.
Example:
```jsx
|
|
| #### onCancel? |
(event: [UploadOnCancelEvent]({% slug api_upload_uploadoncancelevent %})) => void
|
Triggered when the user cancels an upload in progress. Useful for custom cancellation logic.
Example:
```jsx
|
|
| #### onProgress? |
(event: [UploadOnProgressEvent]({% slug api_upload_uploadonprogressevent %})) => void
|
Triggered when the upload progress of a file changes.
Example:
```jsx
|
|
| #### onRemove? |
(event: [UploadOnRemoveEvent]({% slug api_upload_uploadonremoveevent %})) => void
|
Triggered when files are removed. May include a server response if applicable.
Example:
```jsx
|
|
| #### onStatusChange? |
(event: [UploadOnStatusChangeEvent]({% slug api_upload_uploadonstatuschangeevent %})) => void
|
Triggered when the status of files changes. May include a server response if applicable.
Example:
```jsx
|
|
| #### removeField? |
string
|
Sets the [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) key which contains the list of file names that are submitted to `removeUrl`. Defaults to `fileNames`. | |
| #### removeHeaders? |
[UploadHttpHeaders]({% slug api_upload_uploadhttpheaders %})
|
Configures the `HttpHeaders` that are attached to each `remove` request. | |
| #### removeMethod? |
string
|
Sets the [request method](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods) of the `remove` request. Defaults to `POST`. | |
| #### removeUrl? |
string | (files: [UploadFileInfo]({% slug api_upload_uploadfileinfo %})[], options: { formData: FormData; requestOptions: any; }) => Promise<{ uid: string; }>
|
Sets the URL of the endpoint for the `remove` request. The [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) request key is named after the `removeField` property. It contains the list of file names which will be removed. | |
| #### responseType? |
"text" | "arraybuffer" | "blob" | "json"
|
Sets the expected [response type](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/responseType) of the server. Used to parse the response appropriately. Defaults to `json`. | |
| #### restrictions? |
[UploadFileRestrictions]({% slug api_upload_uploadfilerestrictions %})
|
Configures file restrictions such as allowed extensions and maximum file size.
Example:
```jsx
|
|
| #### saveField? |
string
|
Sets the [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) key which contains the files submitted to `saveUrl`. Defaults to `files`. | |
| #### saveHeaders? |
[UploadHttpHeaders]({% slug api_upload_uploadhttpheaders %})
|
Configures the `HttpHeaders` that are attached to each upload request. | |
| #### saveMethod? |
string
|
Sets the [`request`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods) method of the upload request. Defaults to `POST`. | |
| #### saveUrl? |
string | (files: [UploadFileInfo]({% slug api_upload_uploadfileinfo %})[], options: { formData: FormData; requestOptions: any; }, onProgress: (uid: string, event: ProgressEvent<EventTarget>) => void) => Promise<{ uid: string; }>
|
Sets the URL of the endpoint for the upload request. The requested [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) key is named after the `saveField` property and contains the list of files that will be uploaded. | |
| #### selectMessageUI? |
React.ComponentType<[UploadSelectMessageProps]({% slug api_upload_uploadselectmessageprops %})>
|
Customizes the content of the add button in the Upload component.
Example:
```jsx
|
|
| #### showActionButtons? |
boolean
|
true
|
Toggles the visibility of action buttons when `autoUpload` is set to `false`.
```jsx
|
| #### showFileList? |
boolean
|
true
|
Toggles the visibility of the file list in the Upload component.
```jsx
|
| #### tabIndex? |
string | number
|
Sets the `tabIndex` attribute of the Upload component.
Example:
```jsx
|
|
| #### webMcp? |
boolean | WebMcpProps
|
Enables Web MCP tool registration for this component. Requires a parent `WebMcpProvider` from `@progress/kendo-react-webmcp`. | |
| #### withCredentials? |
boolean
|
Configures whether credentials (cookies, headers) will be sent for cross-site requests. Defaults to `true`. Setting `withCredentials` has no effect on same-site requests. To add credentials to the request, use the `saveHeaders` or `removeHeaders` property. |