> 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/plugin-konfiguration.md).

# Plugin configuration

You will find the global settings of the plugin under:

<figure><img src="/files/H6x4mMs0N9UsYqn1v64E" alt=""><figcaption></figcaption></figure>

**Settings > System > Plugins**, then click the context menu **… > Configuration** at the **Article Configurator for Own/Additional Fields** plugin.

The settings are divided into several sections (cards).

## Field management

A hint explaining that the actual management of the configurator is done under **Catalogues > Article Configurator**. There you manage the fields and control the display via checkbox using dependencies.

## Settings

| Option                                           | Key                     | Description                                                                                                                                                                            |
| ------------------------------------------------ | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Enable prices for option fields**              | `enablePrices`          | Enables the price function. Only then can options be given a price or factor (see [Surcharges & multiplier](/artikel-konfigurator/english-documentation/preise-und-multiplikator.md)). |
| **Show attributes in customer comment**          | `showInCustomerComment` | If active, the filled-in attributes are additionally added to the order's customer comment.                                                                                            |
| **Separated quantity for attribute with prices** | `separatedQuantity`     | Planned for a future version, currently disabled.                                                                                                                                      |
| **Display markup factors in cart**               | `displayMarkupFactors`  | Shows the underlying factors in the cart. Only relevant when using multipliers.                                                                                                        |

## When assigning fields via categories

| Option                       | Key                      | Description                                                                            |
| ---------------------------- | ------------------------ | -------------------------------------------------------------------------------------- |
| **Include child categories** | `includeChildCategories` | Additionally takes the subordinate categories of the selected category into account.   |
| **Include parent category**  | `includeParentCategory`  | Additionally takes the superordinate categories of the selected category into account. |

Both options only take effect when the field assignment is done **per category** (see [Field assignment & priorities](/artikel-konfigurator/english-documentation/feldzuordnung.md)).

## Additional field in article for admin (shop operator)

| Option                                                             | Key                      | Description                                                                                                |
| ------------------------------------------------------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------- |
| **Label for the additional field in the order confirmation email** | `konfiguratorAdminLabel` | Defines the label that is output before the text of this additional field in the order confirmation email. |

The corresponding **text** is stored per article in the **General** tab at the very bottom in the **Hubyte Article Configurator** card. This lets the shop operator add an additional, custom entry to the order confirmation email per article.

## Field type: Media upload

| Option                    | Key                   | Description                                               |
| ------------------------- | --------------------- | --------------------------------------------------------- |
| **Show preview image**    | `previewImage`        | Shows a preview image in the article during media upload. |
| **Image width in px**     | `imageWidth`          | Width of the preview image (default: 50).                 |
| **Restrict file formats** | `fileTypeRestriction` | Allows restricting the permitted file formats per field.  |

More on this under [Media upload](/artikel-konfigurator/english-documentation/medienupload.md).

> **Note:** Several settings (e.g. prices) can be set differently per **sales channel**. To do so, select the desired sales channel at the top of the configuration.


---

# 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/plugin-konfiguration.md?ask=<question>
```

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.