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

Elements and field types

A configurator consists of elements that you assemble into a form in the Elements tab. There are three groups: input fields (produce a value), design elements (display only) and structure elements (organise the layout). Structure elements are described separately under Layout & repeaters.

Version note: The input fields are available in every version. Design and structure elements are part of the Premium version – in other versions they are shown in the type selection but disabled (see Advanced & Premium version).

Common settings

Many fields share the same settings:

  • Label: the displayed field name (translatable).

  • Technical identifier: a unique key per configurator (e.g. colour). The value is stored under this name and can be addressed in formulas as fields.colour.

  • Placeholder: grey hint text in the empty field (translatable).

  • Required field: enforces an entry before adding to the cart.

  • CSS class: additional classes for custom styling.

  • Status: Active, Disabled (visible, not operable), Read-only or Hidden.

  • Show in configurator / Show in checkout: controls whether the field appears in the form or in the cart overview.

In addition, every field has a Conditions tab (see Conditional visibility) and – for suitable types – an Info section for a help popover (text, image or video).

Input fields

Field type
Description

Text field

Single-line text, e.g. for names or engraving texts.

Number

Numeric input with optional minimum, maximum and step.

Multiline text

Larger text field for longer entries.

Select list (dropdown)

Single choice from several options. Supports colour/image swatches.

Checkbox group

Multiple choice – the customer can tick several options.

Radio buttons

Single choice as a button/dot list.

Toggle

On/off choice (yes/no).

Slider

Value selection via slider with minimum, maximum and step.

Date

Date selection with optional min/max date.

E-mail

Text field with e-mail validation.

Phone

Text field with phone number validation.

Interim result

Not an input field, but a calculated display value (e.g. "Area: 1.50 m²") that updates live. It is filled via a formula.

Select lists, checkbox groups and radio buttons have an option editor – more about this under Options & swatches.

Design elements

These elements produce no value but structure and explain the form:

Element
Description

Heading

Highlights a section.

Divider

A horizontal line between areas.

Spacer

Adds vertical empty space.

Rich text

Freely formatted HTML content (editor).

Explanation

A formatted hint block.

Notice: success / info / warning / error

Coloured notice boxes (green, blue, orange, red) for important messages.

The info popover

For many input fields you can add extra information in the Info tab – as text, image or video (YouTube/Vimeo, privacy-friendly embedding). The position is selectable, e.g. below the label, left/right of the field or as an info icon that opens a small window. This way you provide guidance without overloading the form.

Tip: Keep labels short and use the info popover for explanations. This keeps your form tidy and reduces questions.

Last updated

Was this helpful?