> For the complete documentation index, see [llms.txt](https://docs.stylemixthemes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stylemixthemes.com/checkout-custom-fields-builder-for-woocommerce/checkout-builder-elements/file-upload.md).

# File Upload

Pro Feature

## **Element Description**

The **File Upload** field allows users to upload files during the checkout process. It supports multiple file formats and can be configured to limit the number and size of files uploaded. This is useful for collecting documents, images, or other relevant files from customers.&#x20;

<figure><img src="https://1670878215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbK04jKOIhkmxYUGKxuyO%2Fuploads%2FeVk87Dw2ds1T0pPfvS6N%2Fimage.png?alt=media&amp;token=6b054c54-2aea-4043-b63d-23f1646e280d" alt=""><figcaption></figcaption></figure>

**Sample Use Cases**

* Collect ID verification documents from customers.
* Request product images or documents for custom orders.
* Gather digital files needed for service fulfillment.

<figure><img src="https://1670878215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbK04jKOIhkmxYUGKxuyO%2Fuploads%2FPp30XvCYwuLETu7KKn1m%2Fimage.png?alt=media&amp;token=121b6610-90b2-4d27-92c5-171631a4f100" alt=""><figcaption><p>Sample File Uploads</p></figcaption></figure>

## **File Upload** Field Settings

<figure><img src="https://1670878215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbK04jKOIhkmxYUGKxuyO%2Fuploads%2FyEpFB7Lt9N9AmrOdoDjV%2Fimage.png?alt=media&amp;token=0c264ad4-1baf-40c9-877e-d43a721702d1" alt=""><figcaption></figcaption></figure>

* **Label** – The name of the field displayed to the customer on the checkout page.
* **Description** – Additional information or instructions about the field, displayed below the file upload button.
* **Enable/Disable Field** – Allows you to enable or disable the field based on your needs. If it is disabled, the element will not be displayed in the checkout form, you can enable it anytime from the checkout builder according to your needs.
* **Is Required** – When enabled, customers must upload a file before completing the checkout process.
* **Selected Files Limit** – The maximum number of files customers can upload (e.g., 2 files).
* **Allowed File Types** – Specify the allowed file formats by entering a comma-separated list (e.g., png, jpg, jpeg).
* **Max File Size in MB** – Set the maximum file size for each upload, in megabytes.

**Advanced Settings**

* **Custom Class Name** – Add [**custom CSS classes**](/checkout-custom-fields-builder-for-woocommerce/plugin-features/custom-classes.md) for additional styling or customization of the file upload field.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stylemixthemes.com/checkout-custom-fields-builder-for-woocommerce/checkout-builder-elements/file-upload.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
