> For the complete documentation index, see [llms.txt](https://docs.premsoft.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.premsoft.de/en/plugins/product-configurator/admin-dashboard/options-and-swatches.md).

# Options and swatches

Select lists, checkbox groups and radio buttons work with **options**. Each option is a selectable answer — and can be much more than just text: it can carry a **surcharge**, bring **dimensions**, or be displayed as a **colour** or **image** tile.

## Creating options

When you select a field with options, the **option editor** appears. Each option can be expanded and consists of several areas.

### General

* **Name:** the displayed option text (translatable), e.g. "Gold".
* **Value:** the technical value that is stored.
* **Display:** *Text* (default), *Colour* or *Image*.
  * For *Colour* you choose a colour value — in the shop a coloured box (swatch) appears.
  * For *Image* you upload an image — in the shop an image tile appears.

### Specifications

Optionally you can store **width, height, length, weight** and a **part number** for each option. These values are available in [formulas](/en/plugins/product-configurator/admin-dashboard/formula.md) (e.g. `options.material.width`) and are useful for calculating dimensions or weight from the selection.

### Price

Here you set the **surcharge** of the option. By default you maintain the price in the default currency; via **Currency dependent pricing** you open a window where you store prices for additional currencies (gross/net each). Without a price the option is simply cost-neutral.

With the **Calculate new price** toggle you can have an option's price determined by a [formula](/en/plugins/product-configurator/admin-dashboard/formula.md) instead of the fixed surcharge — e.g. by dimensions or quantity. This expert calculation is part of the **Premium** version (see [Advanced & Premium version](/en/plugins/product-configurator/versions.md)).

## Show price per option

In the field's settings panel there is the option **Show price below label**. When active, the customer sees the surcharge directly next to the respective choice, e.g. "Gold (+€5.00)".

## Colour and image swatches

If you set an option's display to *Colour* or *Image*, the select list is automatically rendered as an appealing tile selection in the shop — ideal for colours, materials or finishes. This works for both single (radio/dropdown) and multiple choice (checkbox).

## How options affect the price

* **Without a formula:** The product price increases by the sum of all selected option surcharges.
* **With a price formula:** The surcharges are available to the formula as variables; the formula determines the final price. More about this under [The formula](/en/plugins/product-configurator/admin-dashboard/formula.md) and [Price & cart](/en/plugins/product-configurator/storefront/pricing-and-cart.md).

{% hint style="info" %}
You maintain translatable option names by switching the language at the top of the configurator and entering the names per language — see [Multilingual](/en/plugins/product-configurator/admin-dashboard/multilingual.md).
{% endhint %}


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.premsoft.de/en/plugins/product-configurator/admin-dashboard/options-and-swatches.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.