For the complete documentation index, see llms.txt. This page is also available as Markdown.

Pricing and cart

The configurator is price-effective: what the customer selects affects the price immediately — and this price travels correctly into the cart and the order.

Live price on the product page

While the customer configures, the shop recalculates the price in the background and updates the display — without reloading the page. The basis is:

  • Without a price formula: product price + the sum of all selected option surcharges.

  • With a price formula: the result of the formula is the new unit price.

This way the customer always sees what their selection costs.

Transfer into the cart

When the customer adds the configured product to the cart, the following happens:

  • The calculated price is applied and re-checked on every cart update.

  • The entered values are stored on the cart line item and — depending on the plugin configuration — shown as a detail list.

  • Optionally calculated dimensions, weight and a product number are carried along.

  • Different configurations of the same product remain separate line items; identical configurations are merged.

Which fields appear in the cart is controlled globally via Configurator details in checkout and per field via Show in checkout.

Required fields & validation

Before adding to the cart, the shop checks the input:

  • Required fields must be filled in.

  • E-mail and phone fields are checked for a valid format.

  • Number and date fields respect minimum/maximum.

  • Choice fields only accept valid options.

Fields hidden by a condition are not enforced.

Calculated dimensions, weight and product number

In the configurator's Calculation tab you can additionally enable that the configuration calculates width, height, length, weight and a product number. This is useful for:

  • Shipping costs that depend on weight or dimensions,

  • production/picking that needs a meaningful product number.

The calculation is done via formulas and the carried values end up in the order.

Hidden, price-effective fields

A field does not have to be visible to affect the price. Via the field status or Show in configurator you can hide fields whose value still flows into the calculation — e.g. for internal surcharges.

The entire pricing logic is also available through the Store API — ideal for headless frontends that drive price, validation and cart themselves.

Last updated

Was this helpful?