# Checkbox

The **Checkbox** element allows you to add options for customers to choose several among them.

## Element Tab

The primary configuration options for the element can be modified in the Element tab. The Checkbox element contains 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 into 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.
  * **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 the option that is 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="3 Columns" %}

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

{% tab title="4 Columns" %}

<figure><img src="/files/cPjXlZ3mVUNZrOtLQBeP" 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 Checkbox element has the following attributes in the Variants tab:

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

Here are the available variants for the checkbox field:

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

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

{% tab title="Box" %}

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

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

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

{% tab title="Box with Checkbox and Description" %}

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

{% tab title="Box with heading checkbox and description" %}

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

The tab has one more setting at the bottom:

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

## Settings Tab

The Checkbox element contains the following attributes in the Styles tab:

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

* **Required** - Defines whether the element will be required to fill or not.
* **Round Value** - Enable if you do not want to round the value to the whole number.
* **Hidden by Default** - The element will be hidden until a corresponding [**condition**](https://docs.stylemixthemes.com/cost-calculator-builder/calculator-elements/pages/OneKKwO4j2k65VfBcrvD#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/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.&#x20;
* **Show in Grand Total** - Disable if you want to hide the element in Grand Total.
* **Selection Limits** - Ability to set the maximum and minimum number of available options to choose from.
* **Additional Classes** - Add [extra classes](/cost-calculator-builder/plugin-features/additional-classes.md) to the HTML elements to further style changes.

## Example of Using Checkbox Element

Let’s see an example of the Checkbox element in the Cleaning Company Template.

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

How it looks on the user’s page:

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

[^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/checkbox.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.