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