> 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.hubyte.de/artikel-konfigurator/english-documentation/preise-und-multiplikator.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.