> 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/quickstart.md).

# Quickstart

In this chapter you build your first configurator in a few minutes and assign it to a product. We configure a simple example: an engraved sign with a colour selection (with a surcharge) and an engraving text.

{% stepper %}
{% step %}

## Create a configurator

1. Open **Catalogues › Product Configurator**.
2. Click **Create configurator**.
3. In the **General** tab, give it a name, e.g. "Sign configurator", and set it to **Active**.
   {% endstep %}

{% step %}

## Add fields

Switch to the **Elements** tab. On the left you see the element tree, on the right the settings of the selected element.

1. Click **Add element** and choose the type **Select list** (dropdown).
   * Label: "Colour"
   * Technical identifier: `colour`
   * Create three options in the option editor: *Silver*, *Gold*, *Black*.
   * Give *Gold* a surcharge of €5.00, for example.
2. Add a second element of type **Text field**.
   * Label: "Engraving text"
   * Technical identifier: `engraving`
   * Enable **Required field**.

You can find more about all building blocks under [Elements & field types](/en/plugins/product-configurator/admin-dashboard/elements-and-field-types.md).
{% endstep %}

{% step %}

## Assign a product

1. Switch to the **Products** tab.
2. Search for the desired product and add it.
3. **Save** the configurator in the top right.
   {% endstep %}

{% step %}

## View it in the shop

Open the product page in the storefront. Your configurator now appears below the buy area. Choose a colour and enter an engraving text – if you select *Gold*, the price immediately increases by €5.00.
{% endstep %}
{% endstepper %}

## What next?

* Want to calculate the price by dimensions or quantities? → [The formula](/en/plugins/product-configurator/admin-dashboard/formula.md)
* Want to show/hide fields depending on others? → [Conditional visibility](/en/plugins/product-configurator/admin-dashboard/conditional-logic.md)
* Want to control the behaviour in the cart? → [Plugin configuration](/en/plugins/product-configurator/configuration.md)


---

# 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/quickstart.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.