# Image Radio (Pro feature)

The **Image Radio** element is similar to the existing Radio button element. However, the element allows you to add radio button options with a set of images for customers to choose one among them.

## Element Tab

The primary configuration options for the element can be modified in the Element tab. The Image Radio element has the following attributes in the Element tab:

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

* **Element Name** - title of the field.
* **Description** - brief description of the field.
* **Element width -** set how much horizontal space the element occupies in the form relative to the width of the calculator in 100% scale. You will see the changes in real time.
* **Element Columns** - Select how many parts the width of the element should be divided to display the options. This helps organize radio options into multiple columns. It is especially useful when there are many options, making them easier for users to view and select. If 3 is selected, all the options will be displayed in three rows.
* **Options**  - under this section, you can add/remove/reorder options of the radio and assign numerical values to them.&#x20;
  * **Option Label** - Add options for users to choose from.
  * **Option Value** - Add numeric values that will be used in total calculations when an option is selected.
  * **Hint** - a small description of the option can be viewed by hovering the <i class="fa-circle-info">:circle-info:</i> icon next to it.
  * **Upload Image** - here you can select/upload the image to the option.
  * **Add Option** - Adds a new option to the list.
* **Default Value** - Select which option will be preselected when the form loads.
* **Type of Label in Total** - Choose how the selected option will appear in the Summary (Total) section.
  * **Show Value** - Displays the values of the Radio options.
  * **Label Only(No calculation)** - Displays the label of the Radio options, and the value will not be included in Total Calculations. It is useful when the field is used to create [conditions](/cost-calculator-builder/conditional-system/introduction.md).
  * **Label Only(Calculation Value)** - Displays the label of the Radio options, and the value will be included in the total calculations.

{% tabs %}
{% tab title="Show Value" %}

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

**Show Value -** Displays the values of the **Image** **Radio** options.
{% endtab %}

{% tab title="Show Label without Value in Total" %}

<figure><img src="/files/1Iuqj8a56uq3YLJ7ivMJ" alt=""><figcaption></figcaption></figure>

**Show Label without Value in Total** - Displays the label of the **Radio** options and value will not be included in Total Calculations. It is useful when the field is used to create conditions.
{% endtab %}

{% tab title="Show Label with Value in Total" %}

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

**Show Label with Value in Total** - Displays the label of the **Image** **Radio** options and the value will be included in Total Calculations.
{% endtab %}
{% endtabs %}

Here is the example of Image Radio with element columns setting applied:

{% tabs %}
{% tab title="2 column" %}

<figure><img src="/files/Y1cbI3vGkiVhywgkfNvx" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="3 column" %}

<figure><img src="/files/ScIAoi2dRPPDAVCjE67L" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Set Measurement Unit

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

<figure><img src="/files/wACX37IEL9mp6ETLdFVe" alt=""><figcaption></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 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 the fractional part

## Variants Tab

The Variants tab is available in the Pro version of the plugin and there you can adjust the appearance of the field. The Image Radio element contains the following attributes in the Variants tab:

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

Here are the available variants:

{% tabs %}
{% tab title="Default" %}

<figure><img src="/files/hqR2QpTdRE98qd8cLQJs" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Box with icon" %}

<figure><img src="/files/CVVRzyAcwYReQVCfq4tb" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
If you select **the Box with Icon** variant, you have to choose `svg` icons to them in the [Element Tab.](#element-tab)
{% endhint %}

There is one setting at the bottom of the tab:

* **Apply this radio style to all radio fields in this calculator** - When the option is enabled, the selected style will be applied to all Image Radio elements in the calculator that are being edited.

## Settings Tab

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

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

* **Required** - Defines whether the element will be required to be filled or not.
* **Round Value** - Enable if you want to round the value to the whole number in the total summary.
* **Hidden by Default** - The element will be hidden by default. You can make it visible using [**conditional system**](https://docs.stylemixthemes.com/cost-calculator-builder/calculator-elements/pages/OneKKwO4j2k65VfBcrvD#id-1.-hidden-by-default).
* **Calculate hidden by default** - If any case hides the element: via the **Hidden by Default** setting or hidden by some [**condition**](https://docs.stylemixthemes.com/cost-calculator-builder/calculator-elements/pages/OneKKwO4j2k65VfBcrvD#id-2.-calculate-hidden-by-default), the element's default value (if it is set) will be counted in the formula.
* **Show in Grand Total** - Disable if you want to hide the element in Grand Total.
* **Show Value in Element (form)** - enable the setting to show the element's value within the specified area inside the form.
* **Additional Classes** - Add [extra classes](/cost-calculator-builder/plugin-features/additional-classes.md) to the HTML elements to further style changes

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

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

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

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

<figure><img src="/files/5hHw9jICm85wQWHsgJsb" alt=""><figcaption></figcaption></figure>

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

Image Radio <mark style="color:green;">**with**</mark> and <mark style="color:red;">**without**</mark> values:

{% tabs %}
{% tab title="Image Radio WITH value" %}
**Show value in element (form)** setting is <mark style="color:green;">**ON**</mark>

<figure><img src="/files/dNl2FCBIr6DV07CSivQE" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Image Radio WITHOUT value" %}
**Show value in element (form)** setting is <mark style="color:red;">**OFF**</mark>

<figure><img src="/files/kbVrfFyDJgDoyx9ozQAH" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

[^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/radio-button-1.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.