Creating fields & field types

You create fields under Catalogues > Article Configurator > Own/Additional Fields using the Create button. In the detail view of a field, different settings are available depending on the field type.

Example in the storefront

General settings (for all field types)

Setting	Description
Name	Label of the field. Used in the frontend as the caption and in the order as the attribute name.
Placeholder	Optional placeholder shown in the empty input field.
Order	Controls the sorting of multiple fields on the product (lower number = higher up).
Validation (regex)	Optional regular expression to validate the entry (e.g. for postal codes or formats).
Info text	Additional hint text for the field.
Info type	Defines how the info text is displayed: as a tooltip (question mark with mouseover), beside the field or below the field.
Required	If active, the field must be filled in before adding to the cart.
Field type	Determines the type of field (see below).
Show in order documents	If active, the entry is output on documents (e.g. delivery note).

In addition, at the bottom you define for which products, categories or dynamic product groups the field appears – see Field assignment & priorities.

Available field types

Field type	Description & typical use
Text field	Single-line text input, e.g. for an engraving or wish text. Maximum number of characters configurable.
Text area	Multi-line input field for longer texts. Maximum length (characters) configurable.
Number field	Entry of a number, e.g. for quantities or dimensions. Can be used as a multiplier (see Surcharges & multiplier).
Date field	Selection of a date.
Date and time field	Selection of date and time.
Dropdown (select box)	Selection of one value from a list.
Single select (radio button)	Selection of exactly one option from several.
Multi select (checkbox)	Selection of several options.
Color selection as color tile	Selection of a color via clickable color tiles (color name + hex value).
Tooltip / info text	Pure information display beside, below the field or as a tooltip – without input from the customer.
Media upload	File upload by the customer (see Media upload).

Settings depending on the field type

Text field

• Max number of characters – Limits the length of the entry.

Text area

• Max length – Maximum number of characters for the multi-line text.

Number field

• Can optionally be used as a multiplier (multiplies a value by the selling price) with the parameters value, step size, min and max. See Surcharges & multiplier.

Dropdown, single and multi select

• Available options – With prices disabled, enter the options comma-separated, e.g. tea, coffee, water.

• With prices enabled, you instead maintain name + value per option (see Surcharges & multiplier).

Color selection

• Via Add color you create a color name and a hex color per tile. The colors appear as clickable tiles in the frontend.

Info text / tooltip

• Via the info type you control whether the info text appears as a tooltip (question mark with mouseover), beside or below the field.

Tip: Use the order to arrange fields so that the most important or first fields to fill in appear at the top. Required fields should be clearly recognizable – use a meaningful name and an info text if necessary.