--- 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 console.log(event.files)} /> ```
#### 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 console.log(event.additionalData)} /> ```
#### 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 console.log(event.additionalData)} /> ```
#### onCancel? (event: [UploadOnCancelEvent]({% slug api_upload_uploadoncancelevent %})) => void Triggered when the user cancels an upload in progress. Useful for custom cancellation logic. Example: ```jsx console.log('Upload canceled')} /> ```
#### onProgress? (event: [UploadOnProgressEvent]({% slug api_upload_uploadonprogressevent %})) => void Triggered when the upload progress of a file changes. Example: ```jsx console.log(event.affectedFiles[0].progress)} /> ```
#### onRemove? (event: [UploadOnRemoveEvent]({% slug api_upload_uploadonremoveevent %})) => void Triggered when files are removed. May include a server response if applicable. Example: ```jsx console.log(event.files)} /> ```
#### onStatusChange? (event: [UploadOnStatusChangeEvent]({% slug api_upload_uploadonstatuschangeevent %})) => void Triggered when the status of files changes. May include a server response if applicable. Example: ```jsx console.log(event.affectedFiles)} /> ```
#### 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.