# File Upload (Pro feature)

Using the **File Upload** element allows you to upload files in different sizes, quantities and formats.&#x20;

## Element Tab

The File Upload element has the following attributes in the Element Tab:

<figure><img src="/files/GInSjcETNzIhWBGSzYqn" alt=""><figcaption></figcaption></figure>

* Name - Title of the element.
* Description - Description of the element.
* Maximum file size - the maximum size of the file that can be uploaded.

{% hint style="info" %}
The field above takes its value from the configurations of the host server. Learn more about increasing the maximum file size [here](https://app.gitbook.com/o/-MDO-gEg-EzaIBt-7nI8/s/-MDTO7zmTA5-HpvK8JDA/c/Hsa0yQhgwoLAbane3aKP/calculator-elements/file-upload/how-to-increase-maximum-file-upload-size-in-wordpress).
{% endhint %}

* **Maximum attached files** - the maximum quantity of the files that can be attached.
* **File upload price** - shows the file upload price.
* **Supported file formats** - specifies the file formats that can be uploaded.

{% hint style="info" %}
By default, WordPress allows only common file formats to be uploaded. However, all file types can be set as allowed by taking certain steps. To learn more about it navigate to this [section](https://app.gitbook.com/o/-MDO-gEg-EzaIBt-7nI8/s/-MDTO7zmTA5-HpvK8JDA/c/Hsa0yQhgwoLAbane3aKP/calculator-elements/file-upload/how-to-allow-additional-file-types-in-wordpress).
{% endhint %}

## Settings Tab

The **File Upload** element has the following attributes in the Settings Tab:

<figure><img src="/files/SzBxpnT6Mg0lX8RPTL41" alt=""><figcaption></figcaption></figure>

* **Currency Sign** - Enable if you want to show the currency symbol.
* **Required** - Defines whether the element will be required to fill or not.
* **Hidden by Default** - The element will be hidden until a corresponding [**condition**](/cost-calculator-builder/conditional-system/introduction.md) is met. If the element is hidden, its default value will be counted as '0' in the formula &#x20;
* **Calculate hidden by default** - If any case hides the element: via the **Hidden by Default** setting or  hidden by some [**condition**](/cost-calculator-builder/conditional-system/introduction.md), the element's default value (if it is set) will be counted in the formula&#x20;
* **Show in Grand Total** - Disable if you want to hide the element in Grand Total.
* **Additional Classes** - Add extra classes to the HTML elements to further style changes.

### Add a measuring Unit

This setting allows you to add a measuring unit (Ω, cm, kg, inch, etc.) to the field.

<figure><img src="/files/2eZu8wwbW9qSrsvg8aFz" alt=""><figcaption><p>Add a measuring unit</p></figcaption></figure>

* **Unit Symbol** - enter the unit symbol&#x20;
* **Position** - select the position where the symbol should be displayed relative to the number
* **Thousands separator** - select the the symbol to [separate thousands ](#user-content-fn-1)[^1]
* **Number of decimals** - indicate the number of decimals in the fractional part
* **Decimal separator** - select the symbol to separate fractional part

## Example of Using File Upload

To add the **File Upload** element to your calculator simply drag and drop the element to your preferred place of the calculator.  Fill in the fields based on your preference and save the changes.

![](/files/i8L9tZJtPn4GhGEnSa74)

Below you can see the result of the created sample calculator with File Upload element. By **Choose file** button you can upload files directly from your computer or upload files via **URL.**

{% tabs %}
{% tab title="Show in Grand Total enabled" %}

<figure><img src="/files/yTBY5vb0PIn7Ngr3RTjn" alt=""><figcaption></figcaption></figure>

The result of the **File Upload** element will be displayed in the total summary.
{% endtab %}

{% tab title="Show in Grand Total disabled" %}

<figure><img src="/files/ij8pJfi09lNjwfzpqqBc" alt=""><figcaption></figcaption></figure>

The result of the **File Upload** element will not be displayed in the total summary.
{% endtab %}
{% endtabs %}

Received orders can be located in **Dashboard > Cost Calculator > Orders.** Orders with attached files are displayed with **Paper Clip** icon beside them.

![](/files/qKRaafrGca2gmvr0erWb)

Uploaded files are available in the open form on the popup window which appears after clicking the **order**.

![](/files/MtQdAn1dvcSXXQz2lO9Y)

{% hint style="info" %}
When [Woo Checkout](/cost-calculator-builder/cost-calculator-settings/calculator-settings/woo-checkout.md) is enabled in calculator settings the details of the order will be displayed in the WooCommerce orders section and attached files can be found from the order details.
{% endhint %}

[^1]: r.g 7, 000, 000 (seven millions)


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stylemixthemes.com/cost-calculator-builder/calculator-elements/file-upload.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
