Wix Headless: migrar seu site para um front-end personalizado
Este recurso está disponível atualmente apenas para contas em inglês.
Crie um novo site para seu negócio substituindo o front-end criado no Editor Wix por um front-end personalizado criado com uma ferramenta de programação com IA, como Claude Code, Cursor ou Codex.
Os recursos de negócios conectados (por exemplo, Wix Stores e Wix Bookings) e os dados (por exemplo, SEO e análises) continuam funcionando sem interrupção. Se você já tem um front-end personalizado, pode usar sua ferramenta de programação com IA para transformá-lo no front-end do seu site no Wix Headless.
Para quem isso é indicado?
Você pode migrar para um site headless se já tem um site Wix online com um domínio conectado e quer substituir apenas o front-end (a parte que os visitantes veem) por algo criado com uma ferramenta de programação com IA.
Migrar para o Wix Headless pode ser ideal para você se:
- Você tem um site Wix online com recursos de negócios conectados (por exemplo, Wix Stores, Wix Bookings, Contatos e Membros) e quer um novo front-end sem precisar recriar nada disso.
- Você (ou a pessoa ou agência que desenvolve o site) quer total liberdade de design programando o front-end diretamente, em vez de criar no Editor Wix.
- Você quer um novo front-end, mas não quer perder nenhum dado do site, incluindo análises e SEO.
- Você quer experimentar criar com uma ferramenta de programação com IA sem colocar em risco seu site online.
Não migre para o Wix Headless se você prefere criar visualmente no Editor Wix ou no Editor do Wix Studio, ou se não conta com alguém para desenvolver o site nem com um fluxo de trabalho de programação com IA. O Wix Headless parte do princípio de que você traz seu próprio código de front-end.
O que saber antes de começar:
- Seu site precisa de um domínio conectado. A migração para o Wix Headless está disponível apenas para sites com um domínio conectado.
- Só pode haver um front-end online por vez. Quando você muda para o novo front-end, ele substitui o atual para os visitantes. Os dois não ficam online ao mesmo tempo.
- Seu SEO migra junto com o novo front-end. Depois da migração, o SEO e as análises passam automaticamente para o novo front-end. Lembre-se de que é natural que mudanças significativas nas páginas, no conteúdo ou na estrutura do site afetem o SEO.
- Confira quais apps são compatíveis. A maioria dos apps conectados continua funcionando depois da mudança, mas alguns ainda não são compatíveis com o novo front-end. Você ainda pode gerenciá-los no painel de controle do site. Veja a lista completa de apps compatíveis e incompatíveis.
Requisitos para migrar seu site
Seu site precisa atender a todos os requisitos abaixo para você poder iniciar uma migração:
- Você é o proprietário do site: somente o proprietário do site pode iniciar uma migração. Se você é colaborador, peça ao proprietário do site que inicie a migração.
- Seu site tem um domínio personalizado: conecte um domínio ao seu site antes de começar.
- Sua loja usa o novo catálogo do Wix Stores: se seu site usa o Wix Stores, ele precisa ter o novo catálogo de produtos.
- Seu site não usa componentes personalizados de um projeto de app: se seu site atual inclui componentes personalizados criados como parte de um projeto de app, ele ainda não pode ser migrado. Para usar o headless, crie um novo site headless.
Como funciona o processo de migração?
Veja abaixo, etapa por etapa, como funciona o processo de migração. Para começar a migrar, siga os passos na próxima seção.
- Inicie a migração. Você inicia a migração em Configurações headless, no painel de controle do site. Em seguida, você recebe um prompt com os detalhes específicos do seu site.
- Crie seu novo front-end com sua ferramenta de programação com IA. Cole o prompt na ferramenta e crie tudo o que os visitantes veem: páginas, seções e elementos. Comece do zero ou copie seu design atual para usar como base. Você pode criar o front-end durante a migração ou antes de começar.
- Visualize e teste seu novo front-end. O novo front-end aparece como uma visualização separada, ao lado do site atual. Os visitantes veem apenas o site online, então você pode continuar ajustando até que tudo tenha a aparência e o funcionamento que você deseja. Seus produtos, serviços, agendamentos e outros dados continuam no lugar, prontos para se conectar ao novo front-end.
- Mude para o novo front-end. Quando estiver tudo pronto, transforme o novo front-end no seu site online. Seu domínio personalizado e o acompanhamento de dados são transferidos, e o site antigo é despublicado. Apenas as páginas que você adicionou com a ferramenta de programação com IA aparecem no novo site. Você pode voltar ao site anterior a qualquer momento.
Migre seu site para um front-end personalizado
Migre para o Wix Headless, crie seu novo front-end com uma ferramenta de programação com IA e publique quando estiver tudo pronto.
Confira se seu site atende a todos os requisitos acima.
Para migrar seu site para um front-end personalizado:
Acesse Configurações headless no painel de controle do site.
Role para baixo e clique em Iniciar migração em Migração headless.
Clique em Iniciar migração para configurar seu negócio com o novo front-end.
Confira quais apps são migrados e quais não são compatíveis. Em seguida, clique em Continuar.
Clique em Copiar prompt e cole o prompt no seu agente de programação com IA. Assim, o agente recebe informações sobre seu site por meio da habilidade do Headless.

- Crie e aprimore seu front-end com o agente de programação com IA.
- (Opcional) Clique em Ver em Configurações headless para visualizar seu site headless.
- Clique em Concluir migração.
- Copie o prompt e cole-o no seu agente de programação com IA para substituir o front-end atual pelo novo e publicá-lo.
Depois da mudança, confira o que precisa ser recriado, como formulários, redirecionamentos, SEO e análises. Veja a checklist pós-migração e compartilhe com sua ferramenta de programação com IA.
Perguntas frequentes
Clique em uma pergunta abaixo para saber mais sobre a migração para o Wix Headless.
