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

# Traduzioni e lingue

> Configura le impostazioni della lingua per ospiti internazionali usando il supporto multilingue del menu storekit. Traduci l'interfaccia di ordinazione e i contenuti del menu.

storekit supporta più lingue sia per l'interfaccia di ordinazione sia per i contenuti del tuo menu. Questa guida spiega come le impostazioni della lingua influiscono sull'esperienza dell'ospite e come configurarle per il tuo store.

## Lingue supportate

storekit supporta le seguenti lingue:

| Lingua          | Codice |
| --------------- | ------ |
| 🇬🇧 English    | en-GB  |
| 🇫🇷 Français   | fr-FR  |
| 🇪🇸 Español    | es-ES  |
| 🇩🇪 Deutsch    | de-DE  |
| 🇮🇹 Italiano   | it-IT  |
| 🇳🇱 Nederlands | nl-NL  |
| 🇵🇹 Português  | pt-PT  |
| 🇸🇪 Svenska    | sv-SE  |
| 🇩🇰 Dansk      | da-DK  |
| 🇵🇱 Polski     | pl-PL  |
| 🇹🇷 Türkçe     | tr-TR  |
| 🇬🇷 Ελληνικά   | el-GR  |
| 🇯🇵 日本語        | ja-JP  |
| 🇨🇳 简体中文       | zh-CN  |
| 🇹🇼 繁體中文       | zh-TW  |

## Cosa viene tradotto

Le impostazioni della lingua influiscono su due aspetti diversi:

### 1. Testo dell'interfaccia

Tutti i pulsanti, le etichette e i messaggi di sistema in tutto il flusso di ordinazione:

* "Aggiungi al carrello", "Checkout", "Effettua ordine"
* Etichette dei moduli come "Email", "Numero di telefono", "Indirizzo di consegna"
* Messaggi di errore e conferme
* Nomi degli allergeni e tag dietetici
* Notifiche di stato dell'ordine (SMS e notifiche push)

Questo è gestito automaticamente da storekit — nessuna configurazione richiesta.

### 2. Contenuti del menu

I nomi dei tuoi prodotti, le descrizioni, i nomi delle categorie e le opzioni dei modificatori. Questo richiede che tu fornisca le traduzioni nel tuo sistema di gestione del menu o POS.

<Note>
  Le traduzioni dell'interfaccia sono automatiche. Le traduzioni del menu richiedono che tu aggiunga i contenuti tradotti per ogni lingua che vuoi supportare.
</Note>

## Impostazioni della lingua dello store

### Lingua predefinita

La lingua principale del tuo store. Viene usata quando:

* La lingua automatica è disabilitata
* La lingua del browser dell'ospite non è supportata
* Non è possibile rilevare alcuna preferenza linguistica

### Lingua automatica

Quando è attiva, storekit rileva automaticamente la lingua del browser dell'ospite e passa a essa se supportata.

**Come funziona:**

1. L'ospite visita il tuo store
2. storekit controlla l'impostazione della lingua del suo browser
3. Se quella lingua è supportata, lo store viene mostrato in quella lingua
4. Se non è supportata, ripiega sulla tua lingua predefinita

**Ideale per:**

* Aree turistiche con visitatori internazionali
* Hotel e aeroporti
* Aree con popolazioni locali diverse
* Ordinazione al tavolo con QR dove gli ospiti possono essere in visita dall'estero

<Tip>
  La lingua automatica è particolarmente utile per il servizio al tavolo. Un turista francese che scansiona il tuo QR code vedrà automaticamente l'interfaccia in francese.
</Tip>

### Cambio manuale della lingua

Indipendentemente dalle impostazioni della lingua automatica, gli ospiti possono sempre cambiare manualmente la lingua usando il selettore di lingua nel tuo store. Questo apre un modale che mostra tutte le lingue disponibili con i loro nomi nativi ed emoji delle bandiere.

## Traduzioni del menu

Affinché gli ospiti vedano il tuo menu nella loro lingua, devi fornire contenuti tradotti.

### Come funzionano le traduzioni del menu

1. Crei le traduzioni per gli articoli del menu (nomi, descrizioni) in ogni lingua
2. Quando un ospite visualizza il tuo store in francese, storekit richiede la versione francese del tuo menu
3. Nomi e descrizioni dei prodotti sono mostrati in francese
4. Se manca una traduzione, viene mostrato il testo originale

### Cosa tradurre

| Contenuto                         | Priorità                                              |
| --------------------------------- | ----------------------------------------------------- |
| Nomi dei prodotti                 | Alta - gli ospiti devono capire cosa stanno ordinando |
| Descrizioni dei prodotti          | Media - aiuta gli ospiti a decidere                   |
| Nomi delle categorie              | Media - facilita la navigazione                       |
| Nomi dei modificatori             | Media - importante per la personalizzazione           |
| Titoli dei gruppi di modificatori | Bassa - spesso auto-esplicativi                       |

### Fonti delle traduzioni

Le traduzioni del menu possono provenire da:

* **Il tuo sistema POS** - Se il tuo POS supporta menu multilingue, le traduzioni si sincronizzano automaticamente
* **Dashboard storekit** - Aggiungi traduzioni direttamente per ogni articolo del menu
* **Import CSV** - Carica traduzioni in massa tramite foglio di calcolo

<Warning>
  Se attivi la lingua automatica ma non hai traduzioni del menu, gli ospiti vedranno l'interfaccia nella loro lingua ma gli articoli del menu nella tua lingua predefinita. Questo può creare confusione — fornisci le traduzioni oppure disattiva la lingua automatica.
</Warning>

## Best practice

### Se hai ospiti internazionali

1. **Attiva la lingua automatica** - Rimuovi frizioni per i visitatori
2. **Traduci il menu** - Come minimo, i nomi dei prodotti
3. **Testa in ogni lingua** - Verifica che nulla sembri rotto
4. **Considera le descrizioni** - Anche brevi traduzioni aiutano

### Se i tuoi ospiti sono principalmente locali

1. **Imposta la lingua locale come predefinita**
2. **Considera di disattivare la lingua automatica** - Evita confusione se non hai traduzioni
3. **Aggiungi traduzioni in seguito** - Man mano che cresce la tua base di clienti internazionali

### Per zone turistiche

1. **Attiva la lingua automatica**
2. **Dai priorità alle lingue turistiche comuni** - Solitamente inglese, francese, spagnolo, tedesco, cinese
3. **Usa le foto** - Buone foto dei prodotti superano le barriere linguistiche
4. **Mantieni descrizioni semplici** - Più facili da tradurre e capire

## Risoluzione dei problemi

### Il menu mostra lingue miste

**Causa:** la lingua automatica è attiva ma le traduzioni del menu sono incomplete.

**Soluzione:** completa le traduzioni oppure disattiva la lingua automatica finché le traduzioni non sono pronte.

### L'ospite non riesce a trovare il selettore di lingua

Il selettore di lingua compare nel footer o nell'header dello store a seconda del tuo tema. Assicurati che sia visibile e non nascosto da uno stile personalizzato.

### Le traduzioni non si aggiornano

Le traduzioni del menu sono memorizzate in cache. Dopo aver aggiornato le traduzioni:

1. Attendi qualche minuto per la pulizia della cache
2. Aggiorna la pagina con hard refresh (Ctrl+Shift+R / Cmd+Shift+R)
3. Se ancora non compaiono, contatta il supporto


## Related topics

- [Aggiungi e configura prodotti, modificatori e tag del menu](/docs/it/guides/menu/products.md)
- [Crea e programma categorie del menu](/docs/it/guides/menu/categories.md)
- [Notifiche ordine ai clienti](/docs/it/guides/notifications/customer-communication.md)
- [Regioni supportate](/docs/it/getting-started/supported-regions.md)
- [Lingua della dashboard](/docs/it/guides/account/dashboard-language.md)