> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/artikel-konfigurator/english-documentation/preise-und-multiplikator.md).

# Surcharges & multiplier

Fields can influence the price of a product – either via a **fixed surcharge** per option or via a **multiplier (factor)** on the selling price.

## Enabling prices

The price function is enabled globally in the [plugin configuration](/artikel-konfigurator/english-documentation/plugin-konfiguration.md):

**Settings > System > Plugins > Article Configurator … > Configuration**

* **Enable prices for option fields** (`enablePrices`) – Only when this option is active can you store a value (price or factor) for options.

As long as the option is disabled, you simply enter available options **comma-separated** (e.g. `tea, coffee, water`). With prices enabled, you instead maintain **name + value** per option.

## Options with a price (dropdown, single & multi select)

With prices enabled, the field types **dropdown**, **single select** and **multi select** show a list of options, each with two inputs:

| Input           | Meaning                                                                  |
| --------------- | ------------------------------------------------------------------------ |
| **Option name** | Display text of the option, e.g. `Black`.                                |
| **Value**       | The surcharge (e.g. `10`) or – with the multiplier enabled – the factor. |

Use **Add option** to create more options, and the delete icon to remove an option.

### Fixed surcharge

If the **multiplier** toggle is disabled, the **value** is added as a fixed surcharge to the product price. If the customer selects, for example, an option with the value `10`, the unit price increases by 10.

### Multiplier (factor on the selling price)

If the **multiplier** toggle is enabled, the stored **value** of the selected option is **multiplied by the selling price**. This allows price-dependent surcharges (e.g. a percentage surcharge for a particular variant).

## Number field as a multiplier

A **number field** can also act as a multiplier. To do so, enable the **multiplier** toggle in the number field (with prices enabled). The following parameters are available:

| Parameter     | Meaning                                  |
| ------------- | ---------------------------------------- |
| **Value**     | Base value for the multiplication.       |
| **Step size** | Step size for the input in the frontend. |
| **Min**       | Smallest permitted value.                |
| **Max**       | Largest permitted value.                 |

The number entered by the customer is used for the price calculation – ideal e.g. for dimensions or quantities where the price scales with the entry.

## Displaying factors in the cart

In the [plugin configuration](/artikel-konfigurator/english-documentation/plugin-konfiguration.md) you control with **Display markup factors in cart** (`displayMarkupFactors`) whether the underlying factors are shown in the cart. This option is only relevant when you work with **multipliers**.

## Calculation & output

Surcharges and factors are calculated on the server side in the cart and flow into the total price of the line item. In the order, in the cart and on documents, the selected options are shown together with the corresponding price – see [Output in order & documents](/artikel-konfigurator/english-documentation/ausgabe-bestellung-belege.md).

> **Note:** The option **Separated quantity for attribute with prices** (`separatedQuantity`) is planned for a future version and is disabled in the current configuration.