> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Modificatori

> Consenti ai clienti di personalizzare i prodotti storekit con gruppi di modificatori: opzioni, selezioni min/max, scelte gratuite, prezzi e obbligatorietà.

I modificatori permettono ai clienti di personalizzare i prodotti. Sono organizzati in **gruppi di modificatori** - ogni gruppo contiene opzioni e regole su quante possono essere selezionate.

## Esempi

| Gruppo modificatore      | Opzioni                              | Regole                                |
| ------------------------ | ------------------------------------ | ------------------------------------- |
| Scegli la tua dimensione | Piccolo, Medio, Grande               | Obbligatorio, seleziona esattamente 1 |
| Aggiungi topping         | Pepperoni, Funghi, Olive...          | Opzionale, fino a 5                   |
| Seleziona la tua base    | Riso bianco, Riso integrale, Noodles | Obbligatorio, seleziona 1             |
| Salse extra              | Ketchup, Maionese, BBQ...            | Opzionale, seleziona quante vuoi      |

## Creare un gruppo modificatore

1. Clicca su un prodotto per aprire l'editor
2. Vai alla scheda **Modifiers**
3. Clicca su **Add Modifier Group**
4. Inserisci un nome (es. "Scegli la tua dimensione")
5. Aggiungi opzioni con nomi e prezzi
6. Imposta le regole di selezione minima/massima
7. Clicca su **Save Modifiers**

## Impostazioni del gruppo modificatore

### Nome e descrizione

| Campo           | Descrizione                                          |
| --------------- | ---------------------------------------------------- |
| **Name**        | Mostrato ai clienti (es. "Scegli la tua dimensione") |
| **Description** | Contesto extra opzionale                             |
| **SKU / PLU**   | Per l'integrazione POS                               |

### Regole di selezione

Imposta quante opzioni i clienti devono/possono scegliere:

| Impostazione    | Esempio                | Comportamento                           |
| --------------- | ---------------------- | --------------------------------------- |
| Min: 1, Max: 1  | Scegli una dimensione  | Obbligatorio, seleziona esattamente uno |
| Min: 0, Max: 3  | Aggiungi topping       | Opzionale, fino a 3                     |
| Min: 2, Max: 4  | Scegli i tuoi contorni | Obbligatorio, seleziona 2-4             |
| Min: 0, Max: 10 | Salse extra            | Opzionale, seleziona qualsiasi numero   |

<Tip>
  Imposta **Min: 0** per rendere un gruppo modificatore opzionale. Imposta **Min: 1** o superiore per renderlo obbligatorio.
</Tip>

### Consenti più opzioni uguali

Abilita **Allow customers to select an option more than once** per casi come:

* "2x formaggio extra"
* "3x bacon"

Puoi opzionalmente impostare un limite specifico per opzione.

### Modificatori gratuiti

Imposta un numero di **Free Modifiers** per dare ai clienti un certo numero di selezioni gratuite prima di addebitare. Utile per:

* "Primi 3 topping gratuiti, poi £0,50 ciascuno"
* "Include 2 salse, salse extra £0,30"

## Opzioni del modificatore

Ogni opzione all'interno di un gruppo ha:

| Campo              | Descrizione                           |
| ------------------ | ------------------------------------- |
| **Name**           | Nome dell'opzione mostrato ai clienti |
| **Price**          | Costo aggiuntivo (può essere £0)      |
| **Original Price** | Per mostrare sconti sulle opzioni     |
| **POS ID**         | Per l'integrazione POS                |
| **Tax Rate**       | Sovrascrivi la tassa predefinita      |
| **Default Qty**    | Pre-selezione di questa opzione       |
| **In Stock**       | Attiva/disattiva la disponibilità     |

### Quantità predefinita

Pre-seleziona le opzioni impostando una quantità predefinita. Il totale di tutte le quantità predefinite non può superare il massimo del gruppo.

### Disponibilità dell'opzione

Disattiva **In Stock** per nascondere temporaneamente un'opzione senza eliminarla.

### Tag e allergeni

Le opzioni del modificatore possono avere le proprie informazioni sugli allergeni, tag dietetici e dati nutrizionali. Quando un cliente seleziona le opzioni, viene mostrata l'informazione combinata sugli allergeni dal prodotto e da tutti i modificatori selezionati.

Vedi [Tag e allergeni](/docs/it/guides/menu/tags-allergens) per i dettagli.

## Impostazioni di visualizzazione

### Impostazione di visualizzazione iniziale

Controlla come il gruppo modificatore appare nella pagina del prodotto:

| Impostazione  | Comportamento                                 |
| ------------- | --------------------------------------------- |
| **Expanded**  | Opzioni visibili immediatamente (predefinito) |
| **Collapsed** | Opzioni nascoste dietro un tocco/click        |

### Stampa come prodotti

Abilita **Print modifier options as products** per stampare ogni modificatore selezionato sulla propria riga sulle ricevute, piuttosto che come sotto-articoli sotto il prodotto.

## Riutilizzo dei gruppi modificatori

Puoi collegare gruppi di modificatori esistenti a più prodotti:

1. Apri la scheda Modifiers di un prodotto
2. Clicca su **Add Existing Group**
3. Seleziona dai tuoi gruppi modificatori esistenti

Le modifiche a un gruppo modificatore condiviso influiscono su tutti i prodotti che lo utilizzano.

<Warning>
  La modifica di un gruppo modificatore condiviso lo aggiorna ovunque venga utilizzato. Crea un nuovo gruppo se hai bisogno di opzioni diverse per prodotti specifici.
</Warning>

## Riordino

* Trascina i gruppi modificatori per cambiare il loro ordine sul prodotto
* Trascina le opzioni all'interno di un gruppo per cambiare il loro ordine

## Eliminare i gruppi modificatori

1. Apri il gruppo modificatore
2. Clicca su **Remove Group**

Questo rimuove il gruppo dal prodotto corrente. Se è condiviso con altri prodotti, rimane su quei prodotti.

## Suggerimenti

* **Assegna nomi chiari ai gruppi** - "Scegli la tua dimensione" non "Opzioni di dimensione"
* **Ordina le opzioni logicamente** - Dal più piccolo al più grande, o le più popolari per prime
* **Usa opzioni a £0** - Per sostituzioni o preferenze (es. "Senza cipolle")
* **Imposta limiti sensati** - Troppe opzioni sopraffanno i clienti
* **Usa i modificatori gratuiti** - Incoraggiano la personalizzazione senza complessità


## Related topics

- [Panoramica del menu](/docs/it/guides/menu/overview.md)
- [Struttura del menu](/docs/it/guides/menu-engineering/menu-structure.md)
- [Modificatori gratuiti](/docs/it/guides/menu/free-modifiers.md)
- [Modificatori di rimozione](/docs/it/guides/menu/removal-modifiers.md)
- [Stampa i modificatori come prodotti](/docs/it/guides/menu/print-modifiers-as-products.md)