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

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](/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. --- # 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: ``` GET https://docs.hubyte.de/artikel-konfigurator/english-documentation/felder-anlegen.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.