> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/artikel-konfigurator/english-documentation/felder-anlegen.md).

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

<figure><img src="/files/JOJCzmenDTc2pAAgNiYc" alt=""><figcaption><p>Example in the storefront</p></figcaption></figure>

## 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](/artikel-konfigurator/english-documentation/feldzuordnung.md).

## 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](/artikel-konfigurator/english-documentation/preise-und-multiplikator.md)). |
| **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](/artikel-konfigurator/english-documentation/medienupload.md)).                                                                              |

## 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](/artikel-konfigurator/english-documentation/preise-und-multiplikator.md).

### 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](/artikel-konfigurator/english-documentation/preise-und-multiplikator.md)).

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