# 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="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2Fvdh8MdIuOUBp6MZPFV0L%2Fimage.png?alt=media&#x26;token=bbc75a6b-ad39-4960-bb9b-98201ada8d8e" alt=""><figcaption></figcaption></figure>

* **Element Name** - in this section you can set a name to the field that will be visible to users in front end to the radio field. It has two fields:
  * **Name** - Title of the element.
  * **Description** - Description of the element.
  * **Hint** - adds a small <i class="fa-square-info">:square-info:</i> icon next to option to get more info about the option.
* **Element Width (%)** - Defines how much horizontal space the element occupies in the form layout.
* **Element Columns** - Select into 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 raws.
* **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.
* **Select an 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](https://docs.stylemixthemes.com/cost-calculator-builder/conditional-system).
  * **Label Only(Calculation Value)** - Displays the label of the Radio options and the value will be included in Total Calculations.

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

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FtzDrN4iJDbxT6LUs0FWO%2FCCBN%203.1.7%20-%20Image%20Radio%20show%20value.png?alt=media&#x26;token=1f0cd34f-40da-435f-85ba-f37db2e00a70" 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="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FuNicDgjiZuDRXLXbualj%2FCCBN%203.1.7%20-%20Image%20Radio%20show%20label%20without%20value.png?alt=media&#x26;token=9b5321f7-7e64-49e9-adb7-46693711e914" 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="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FeHVttPXlQ9eDiY2V714K%2FCCBN%203.1.7%20-%20Image%20Radio%20show%20label%20with%20value.png?alt=media&#x26;token=1d2487bb-7a0c-46e6-a03a-2710a7941e82" 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="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FG6GYijQETXTDevVx3mQO%2Fimage.png?alt=media&#x26;token=68073cec-7632-4e12-9ba9-94033ba766ee" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="3 column" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FM5JLSaf4x39uoWpAXMwg%2Fimage.png?alt=media&#x26;token=45537756-d922-45d6-96fd-bc18acaca7c6" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## 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="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2F5kgIRTuolZdEwhYBvyfj%2Fimage.png?alt=media&#x26;token=e3fb5fca-b832-4ef6-885e-c1fb0377605a" alt=""><figcaption></figcaption></figure>

Here are the available variants:

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

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FeHVttPXlQ9eDiY2V714K%2FCCBN%203.1.7%20-%20Image%20Radio%20show%20label%20with%20value.png?alt=media&#x26;token=1d2487bb-7a0c-46e6-a03a-2710a7941e82" alt=""><figcaption></figcaption></figure>
{% endtab %}

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

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FcPaguusdoxu5dyQnWSmK%2FCCBN%203.1.7%20-%20Image%20Radio%20box%20with%20icon%20horizontal.png?alt=media&#x26;token=8be009b1-f86f-4adb-9876-2d43e0fdb870" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
If you select **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 selected style will be applied to all Image Radio elements in the calculator which is being edited.

## Settings Tab

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

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FEpL00qWprWj3QdHmobV8%2Fimage.png?alt=media&#x26;token=d6d0d3d0-8db3-42fc-85cc-5448f1c26f96" alt=""><figcaption></figcaption></figure>

* **Currency Sign** - Enable if you want to show the currency symbol in the total summary
* **Required** - Defines whether the element will be required to be filled or not
* **Round Value** - Disable if you don't want to round value to the whole number in the total summary
* **Hidden by Default** - The element will be hidden until a corresponding [**condition**](https://docs.stylemixthemes.com/cost-calculator-builder/conditional-system/condition-actions#id-1.-hidden-by-default) 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**](https://docs.stylemixthemes.com/cost-calculator-builder/conditional-system/condition-actions#id-2.-calculate-hidden-by-default), 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.
* **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 to the HTML elements to further style changes

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

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FtzDrN4iJDbxT6LUs0FWO%2FCCBN%203.1.7%20-%20Image%20Radio%20show%20value.png?alt=media&#x26;token=1f0cd34f-40da-435f-85ba-f37db2e00a70" 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="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2F6rDioMdvQlvudXxmZpbN%2FCCBN%203.1.7%20-%20Image%20Radio%20grand%20total%20off.png?alt=media&#x26;token=8e95f72c-362d-4204-af98-bb4b4bebd168" alt=""><figcaption></figcaption></figure>

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

### Add a measuring Unit

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

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FaUEJlb55NNb0RUXVv0Hq%2Fimage.png?alt=media&#x26;token=cee277e1-e79f-4980-9e14-5e182e29490a" 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

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="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2F5hOYJZkNxiiLUftUQJh2%2Fimage.png?alt=media&#x26;token=9cb9ade5-b976-4f40-94f7-f62f4d723d59" 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="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2Fey7nZp4lOJ84aISMPcTK%2Fimage.png?alt=media&#x26;token=6cb34b45-f8d7-47bf-bf4c-005bea090a0f" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

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