# Wix Headless: passare a un front-end personalizzato

Source: https://support.wix.com/it/article/wix-headless-passare-a-un-front-end-personalizzato (updated 2026-11-03)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

> Questa funzionalità è attualmente disponibile solo per gli account in inglese.

Crea un nuovo sito per la tua attività sostituendo il front-end realizzato nell'Editor Wix con un front-end personalizzato creato utilizzando uno strumento di programmazione con AI, come Claude Code, Cursor o Codex.

Tutti gli strumenti aziendali collegati (es. Wix Stores, Wix Bookings) e i dati (es. SEO, statistiche) continuano a funzionare senza interruzioni. Se hai già un front-end personalizzato, puoi utilizzare il tuo strumento di programmazione con AI per trasformarlo nel front-end Wix Headless.

[Video](https://www.youtube.com/embed/ydHT8tO0j70)

---

## A chi è rivolto?

Puoi passare a un sito Headless se hai già un sito Wix online con un dominio personalizzato e vuoi sostituire solo il front-end (la parte che vedono i visitatori) con uno creato utilizzando uno strumento di programmazione con AI.

Il passaggio a Wix Headless potrebbe essere adatto a te se:

* Hai un sito Wix online con strumenti aziendali collegati (es. Wix Stores, Wix Bookings, Contatti, Membri) e vuoi un nuovo front-end senza dover ricreare nulla.
* Tu, lo sviluppatore o l'agenzia che si occupa del sito volete la massima libertà di design programmando direttamente il front-end, anziché crearlo nell'Editor Wix.
* Vuoi un nuovo front-end senza perdere i dati del sito, incluse le statistiche e la SEO.
* Vuoi provare a creare un front-end con uno strumento di programmazione con AI senza mettere a rischio il tuo sito online.

> **Nota:** Non passare a Wix Headless se preferisci creare il sito visivamente nell'Editor Wix o nell'Editor Studio oppure se non hai uno sviluppatore o un flusso di lavoro basato sulla programmazione con AI. Wix Headless presuppone che tu disponga del codice del tuo front-end.

### Cosa sapere prima di iniziare

* **Il tuo sito deve avere un dominio personalizzato.** Il passaggio a Wix Headless è disponibile solo per i siti con un dominio personalizzato.
* **Puoi avere un solo front-end online alla volta.** Il passaggio al nuovo front-end sostituisce quello attuale per i visitatori: non possono essere entrambi online contemporaneamente.
* **La SEO viene trasferita al nuovo front-end.** Dopo il passaggio, la SEO e le statistiche vengono associate automaticamente al nuovo front-end. Tieni presente che modifiche significative alle pagine, ai contenuti o alla struttura del sito possono influire naturalmente sulla SEO.
* **Controlla quali app sono supportate.** La maggior parte delle app collegate continua a funzionare dopo il passaggio, ma alcune non sono attualmente supportate nel nuovo front-end. Puoi comunque gestirle dal Pannello di controllo del sito. [Consulta l'elenco completo delle app supportate e non supportate.](https://support.wix.com/it/article/wix-headless-supported-and-unsupported-apps)

### Requisiti per il passaggio del sito

Prima di poter avviare il passaggio, il sito deve soddisfare tutti i seguenti requisiti:

* **Sei il proprietario del sito:** solo il proprietario del sito può avviare il passaggio. Se sei un collaboratore, chiedi al proprietario del sito di avviarlo.
* **Il tuo sito ha un dominio personalizzato:** [collega un dominio](https://support.wix.com/it/article/about-domains) al sito prima di iniziare.
* **Il tuo negozio utilizza il nuovo catalogo di Wix Stores:** se il sito utilizza Wix Stores, deve disporre del [nuovo catalogo prodotti](https://support.wix.com/it/article/introducing-the-new-wix-stores-product-catalog).
* **Il tuo sito non utilizza componenti personalizzati di un progetto di app:** se il sito attuale include componenti personalizzati creati come parte di un progetto di app, non può ancora effettuare il passaggio. Per passare alla modalità Headless, [crea invece un nuovo sito Headless](https://support.wix.com/it/article/wix-headless-creating-a-site-with-ai-tools).

---

## Come funziona il processo di passaggio?

Ecco una descrizione dettagliata, passaggio dopo passaggio, di come funziona il processo di passaggio. Per iniziare, segui i passaggi nella sezione successiva.

1. **Avvia il passaggio.** Puoi avviarlo dalle Impostazioni Headless nel Pannello di controllo del tuo sito. Headless ti fornisce un prompt con i dettagli specifici del tuo sito.
2. **Crea il nuovo front-end con il tuo strumento di programmazione AI.** Incolla il prompt nel tuo strumento di programmazione AI, quindi crea tutto ciò che vedono i visitatori: pagine, sezioni ed elementi. Parti da zero oppure copia il design attuale come base. Puoi creare il front-end durante il passaggio o prima di iniziare.
3. **Vedi in anteprima e testa il nuovo front-end.** Il nuovo front-end appare come una visualizzazione separata accanto al sito attuale. I visitatori vedono solo il sito online, quindi puoi continuare a perfezionarlo fino a quando tutto non avrà l'aspetto e il funzionamento che desideri. I prodotti, i servizi, le prenotazioni e gli altri dati rimangono invariati, pronti per essere collegati al nuovo front-end.
4. **Passa al nuovo front-end.** Quando è tutto pronto, imposta il nuovo front-end come sito online. Il dominio personalizzato e il monitoraggio dei dati vengono trasferiti e il vecchio sito viene rimosso dalla pubblicazione. Nel nuovo sito appaiono solo le pagine che hai aggiunto con lo strumento di programmazione AI. Puoi tornare al sito precedente in qualsiasi momento.

---

## Passare a un front-end personalizzato

Passa a Wix Headless, crea il nuovo front-end con uno strumento di programmazione AI e pubblicalo quando è tutto pronto.

> **Prima di iniziare:** Assicurati che il sito soddisfi tutti i [requisiti](https://support.wix.com/it/article/wix-headless-moving-your-site-to-a-custom-frontend#requirements-for-migrating-your-site) indicati sopra.

### Passare a un front-end personalizzato:

1. [Vai a Impostazioni Headless](https://manage.wix.com/my-account/site-selector/?siteType=HtmlWeb&actionUrl=https://www.wix.com/dashboard/{{metaSiteId}}/oauth-apps-settings?referralInfo=settings-lobby?&title=Select%20a%20site&buttonText=Go+to+Headless+Settings) nel Pannello di controllo del tuo sito.
2. Scorri in basso e clicca su **Avvia il passaggio** sotto **Passaggio a Headless**.
3. Clicca su **Inizia ora** per configurare la tua attività con il nuovo front-end.
4. Controlla quali app verranno trasferite e quali non saranno supportate, quindi clicca su **Continua**.
5. Clicca su **Copia prompt** e incollalo nel tuo Assistente AI per la programmazione. In questo modo, l'Assistente riceve informazioni sul tuo sito specifico tramite la funzionalità Headless.

![La fase Copia prompt del processo di passaggio a Headless.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/0e97b94c-47b2-498e-a44b-b1be88db7e56/2026/10/07/0de5e88d-3cf9-4200-9aa4-9612fdc88b1d/Headless_migration.jpg)

1. Crea e perfeziona il front-end con il tuo Assistente AI per la programmazione.
2. (Facoltativo) Clicca su **Visualizzazione** nelle Impostazioni Headless per vedere in anteprima il tuo sito Headless.
3. Clicca su **Completa il passaggio**.
4. Copia e incolla il prompt nel tuo Assistente AI per la programmazione per sostituire e pubblicare il nuovo front-end.

> **Passaggi successivi:** Dopo il passaggio, controlla cosa deve essere ricreato, ad esempio moduli, reindirizzamenti, SEO e statistiche. Consulta la [checklist successiva al passaggio](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/get-started/post-migration-checklist-wix-studio-and-editor-sites-to-headless) e condividila con il tuo strumento di programmazione AI.

---

## FAQ

Clicca su una domanda qui sotto per scoprire di più sul passaggio a Wix Headless.

**Posso vedere in anteprima il nuovo front-end prima di effettuare il passaggio?**

Sì. Puoi vedere in anteprima il nuovo front-end tutte le volte che vuoi prima di effettuare il passaggio. Il sito attuale rimane online e non cambia nulla fino a quando non deciderai di effettuare il passaggio.

**Posso creare il mio front-end prima di iniziare il passaggio?**

Sta a te. Puoi scegliere di creare prima il tuo front-end personalizzato con il tuo strumento di programmazione AI e integrarlo quando vuoi effettuare il passaggio, oppure avviare il passaggio e svilupparlo man mano.

**Il passaggio al nuovo front-end è permanente?**

No. Puoi sempre tornare al sito precedente cliccando su **Torna al sito precedente** nella pagina Impostazioni Headless del Pannello di controllo del tuo sito.

**Cosa succede al mio sito precedente dopo il passaggio?**

> Una volta pubblicato, il nuovo front-end diventa il tuo sito principale. Ciò significa che:
> 
> * Il tuo dominio personalizzato passa al nuovo sito e il sito precedente non è più pubblicato.
> * Strumenti come la SEO e le statistiche iniziano invece a monitorare il nuovo front-end
> * Le pagine presenti solo sul sito precedente vengono nascoste
> * [Le app non supportate](https://support.wix.com/it/article/wix-headless-supported-and-unsupported-apps) non sono disponibili nel nuovo front-end, ma puoi comunque gestirle dal Pannello di controllo.

**Cosa succede alla SEO e alle statistiche?**

La SEO e le statistiche restano associate al tuo sito attuale fino al passaggio. Dopodiché, vengono trasferite automaticamente al nuovo front-end. Tieni presente che modifiche sostanziali alle pagine, ai contenuti o alla struttura del sito possono naturalmente influire sulla SEO.

**Il mio pacchetto Wix cambierà?**

No. Il tuo sito mantiene il pacchetto attuale mentre crei e vedi in anteprima il front-end e poi effettui il passaggio.

**Perché alcuni link alle mie vecchie pagine smettono di funzionare dopo il passaggio?**

Dopo il passaggio, sul tuo dominio sono online solo le pagine che crei nel nuovo front-end. Le pagine presenti solo sul sito precedente vengono nascoste, quindi i relativi link (es. preferiti, risultati di ricerca o campagne di marketing) portano a una pagina di errore 404.

Per continuare a far funzionare questi link, [configura reindirizzamenti 301](https://support.wix.com/it/article/setting-up-a-301-redirect-for-a-page-on-your-site) dai vecchi URL alle pagine corrispondenti del nuovo front-end. Puoi utilizzare lo stesso Gestore reindirizzamento URL che usi attualmente. Se il tuo sito utilizza Wix Multilingua, puoi anche [configurare reindirizzamenti specifici per lingua](https://support.wix.com/it/article/setting-up-a-301-redirect-for-a-multilingual-site).

**Posso continuare a utilizzare Moduli Wix?**

Sì. Moduli Wix continua a funzionare dal Pannello di controllo, inclusi invii, contatti, automazioni ed email di notifica. Tuttavia, i moduli che hai aggiunto nell'Editor non appaiono nel nuovo front-end. 

Chiedi al tuo strumento di programmazione AI o allo sviluppatore di ricrearli nel nuovo front-end e collegarli utilizzando le [API di Moduli Wix](https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/introduction). Gli invii precedenti non vengono eliminati.

**Wix Multilingua funziona con il mio nuovo front-end?**

Sì. Il tuo strumento di programmazione AI o lo sviluppatore può [aggiungere il supporto multilingue](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/add-multilingual-support) al nuovo front-end. Puoi quindi gestire le traduzioni dalla sezione **Headless** del Gestore traduzioni nel Pannello di controllo. 

Le traduzioni del sito precedente non vengono copiate automaticamente, quindi devi tradurre i contenuti mostrati nel nuovo front-end.

**Cosa succede a Wix Chat?**

Il widget Wix Chat non appare sul tuo nuovo front-end e Wix Smart Chat [non è attualmente supportato](https://support.wix.com/it/article/wix-headless-supported-and-unsupported-apps). Entrambi rimangono installati sul tuo sito e puoi continuare a gestirli dal Pannello di controllo.

Se vuoi consentire ai visitatori di chattare con te, il tuo sviluppatore può creare una chat personalizzata sul nuovo front-end utilizzando le [API AI Site-Chat](https://dev.wix.com/docs/api-reference/business-management/ai-site-chat/introduction). Puoi continuare a rispondere ai messaggi dalla Casella di posta e dall'app Wix.

**Importante:** assicurati che Wix Smart Chat sia installato e configurato sul tuo sito attuale prima di effettuare il passaggio. Non potrai aggiungerlo dopo che il nuovo front-end sarà online.

**Cosa succede al mio codice Velo?**

Il codice Velo nelle tue pagine smette di essere eseguito dopo il passaggio, perché i visitatori non caricano più le pagine del tuo vecchio sito. Il codice back-end (es. funzioni HTTP, processi programmati e hook dati) non viene eliminato:

* Il tuo nuovo front-end può continuare a chiamare le [funzioni HTTP](https://dev.wix.com/docs/go-headless/coding/java-script-sdk/calling-site-http-functions) esistenti.
* Il codice pagina e i moduli web (file .jsw) devono essere ricreati nel nuovo front-end.

Se torni al tuo vecchio sito, il codice Velo sarà ancora disponibile.
