# Multi Range (Pro feature)

With the **Multi Range** element, you can give different ranges independently for the left and right sides.

## Element Tab

The Multi Range element contains 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%2FQ52odGRHrAhmXMh683up%2Fimage.png?alt=media&#x26;token=44a70f7c-844c-4a75-88a1-57e70431497c" alt=""><figcaption></figcaption></figure>

* **Name** - Title of the element
* **Description** - Description of the element
* **Minimum Range Value** - minimum value that the multi-range slider can take
* **Maximum Range Value** - maximum value that the multi-range slider can take
* **Default Start Value** – the initial lower bound of the slider range that is pre-selected when the slider loads.
* **Default End Value** – the initial upper bound of the slider range that is pre-selected when the slider loads.
* **Range Step** - shows the step to grow the range. The field will be **disabled** if the **Jump between scale points** setting is enabled or the [**Input** ](#input)**slider style** is selected.
* **Slider Scale Points** - specify the exact data points to emphasize on the slider. Enter multiple values **separated by commas**, using **dots for decima**l numbers. *Example: 7.5, 10, 13.5*
* **Name of Value** - here you can put unit measures, such as kg(kilograms), gr(grams), m (meters), etc. There is also an option to choose the alignment of the units against the value.
* **Jump Between Scale Points** - when enabled, the slider will lock to the specified scale points, ensuring users can only select predefined values in **Slider Scale Points** and not anything in between.

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FyJG8eepTqAZiLgj8FbV2%2F%E2%80%B9%20Cost%20Calculator%20%E2%80%94%20WordPress%20(1)%20(1).gif?alt=media&#x26;token=72c16894-530a-4eeb-a4c2-67df19afe202" alt=""><figcaption><p><strong>Jump Between Scale Points</strong></p></figcaption></figure>

* **Multiply by Unit Price** – enables the use of a unit price multiplier. When toggled on, the final value will be calculated by multiplying the selected value by the specified unit price.

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FdW60f5dCVE7mlUfP7ZmB%2Fimage.png?alt=media&#x26;token=32e36a6c-ec69-4aae-9492-91df95651a8d" alt=""><figcaption></figcaption></figure>

* **Unit Price** – the cost per unit of the selected value. This numeric field supports decimal values and defines how much each unit contributes to the total.
* **Unit** – a label indicating the measurement unit used for the selected value (such as centimeters, meters, or inches).
* **Replace Subtotal with Multiplied Value** – when enabled, this option replaces the original subtotal with the calculated value from the multiplication. Useful for pricing scenarios based on custom measurements.

## Styles

Under this tab, you can select the suitable slider range style according to your needs:

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2F1NPfCYmCAn8aoQUTOXkE%2Fimage.png?alt=media&#x26;token=c71d7b95-1512-4e9a-9d1c-944cf1143676" alt=""><figcaption></figcaption></figure>

Here are the available styles:

{% 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%2FoGxUPXzZHkSNMIRkFG4r%2Fimage.png?alt=media&#x26;token=c52b064e-bdc9-41da-933c-41f3b6205e4a" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Small" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FjM65R0aR6JyY9y2gt8YI%2Fimage.png?alt=media&#x26;token=6ea59524-2bcb-43ff-abc7-95c3dc7630c8" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Multi Point" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FIS2F1LJcMJh0hsYtXGbo%2Fimage.png?alt=media&#x26;token=b8f3ec55-e97d-40b9-9607-2d897fc1c892" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Flat Minimal" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2Fen8alUrUepUyemyzvLqr%2Fimage.png?alt=media&#x26;token=787a7200-7da8-4c5c-81b9-d99df431faad" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Modern" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FzTAM4JkhEoH4uG9KSSla%2Fimage.png?alt=media&#x26;token=7024b823-750b-49fd-bdcc-b134045f1054" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Input" %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2F1ROWVfumbDOxAuetAVgD%2Fimage.png?alt=media&#x26;token=3e026647-df89-43d7-bdd3-8650c3f30c0f" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## Settings Tab

The Multi Range element contains 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%2FqHYspOQm0JsvpDBtblk5%2Fimage.png?alt=media&#x26;token=27bdbfd7-7d9a-4df5-8422-32ef4ae7270a" alt=""><figcaption></figcaption></figure>

* **Currency Sign**- any sign for the range of this element
* **Hidden by Default** - The element will be hidden until a corresponding condition is met
* **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), the element's default value (if it is set) will be counted in the formula&#x20;
* **Round Value** - The value will be rounded
* **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 make 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="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 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

## Example of Using Multi Range Element

Now let’s build a property viewing calculator for a real estate agency. The calculator will have the fields to choose the district, type, extra features(number of rooms, benefits), and the date to look at the property. There will be a **Multi Range** field for users to define the range of the price.

{% hint style="info" %}
Pay attention to the **Maximum Range Value** and **Default Start Value & Default End Value**. The **Default Start Value** cannot be higher than the **Maximum Range Value.**
{% endhint %}

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2Fcl1Bc6npOshP40NLXwOu%2Fimage.png?alt=media&#x26;token=7737fc51-37d0-4637-ad8b-94c4fe3b0bc1" alt=""><figcaption></figcaption></figure>

This is how it will look on the user’s page:

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FfqTQGtiP2uB1xNl9A47J%2F2.png?alt=media&#x26;token=d7cc967a-58b4-4061-b717-16f86f327615" alt=""><figcaption></figcaption></figure>

You can set up **Multiply (cost per value)** when you want the value a user inputs to multiply for the cost. For example, if a book cafe wants to offer quarterly packages based on the number of books. The values will multiply by 1.5 to calculate quarterly subscriptions.

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FC8uyBFjTyRBG3Ai6g2Zi%2Fmultirange3.png?alt=media&#x26;token=454e79ca-b64a-4617-b718-df38d116bf77" alt=""><figcaption></figcaption></figure>

That is how the user will see the calculator:

<figure><img src="https://834137925-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTO7zmTA5-HpvK8JDA%2Fuploads%2FAKcnVvWmDhvpxzmT0HSv%2F2.png?alt=media&#x26;token=15676369-6c67-42d0-92c5-7fc685380783" alt=""><figcaption></figcaption></figure>

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