Como testar atualizações do meu layout na Nuvemshop sem perder as personalizações?

Veja quando há uma versão nova do seu layout, entenda o que muda em cada atualização e aplique em um rascunho para revisar antes de publicar na sua loja.

Última atualização: 18/09/2026

Os layouts baseados em seções, como o Ipanema, recebem melhorias e correções da Nuvemshop ao longo do tempo. Cada versão é registrada, então você consegue ver o que mudou, comparar com o que foi personalizado na sua loja e aplicar a atualização sem descartar as suas alterações.

Isso resolve um problema comum em lojas personalizadas por agências, que antes ficavam paradas em uma versão antiga do layout para não perder as customizações.

Neste tutorial, te mostramos quando as atualizações são aplicadas automaticamente e como identificar quando tem atualizações disponíveis para testar na sua loja que possui personalizações.

Quando o layout é atualizado automaticamente?

A atualização automática de melhorias e correções da Nuvemshop depende se o código do seu layout está ou não liberado para edição.

Se o layout está como veio da loja de temas, ele recebe sozinho as versões intermediárias e menores, sem que você faça nada. Nesse caso, o aviso de atualização aparece apenas quando existe uma versão maior nova, porque ela pode trazer mudanças incompatíveis e a decisão de adotar é sua.

Importante

As atualizações automáticas mexem somente no código base do layout. O conteúdo que você montou nas páginas e nas seções, junto com as configurações de design, permanece como você deixou.

Como ver se há uma atualização disponível para o meu layout?

O aviso aparece no próprio painel administrador. Para consultar, siga os passos abaixo:

1. Acessar o painel administrador da sua loja.

2. Ir em "Loja online > Layout".

3. No layout atual conferir a indicação de "Nova versão disponível", que mostra a versão em uso e a versão de destino.

4. Se preferir aplicar a atualização mais tarde, clicar em “Lembrar mais tarde” para o aviso voltar a aparecer depois. Ao clicar nos três pontinhos, você consegue conferir isso a qualquer momento também.

Pronto!

O tamanho da mudança define o cuidado necessário: correções e recursos novos são compatíveis com a versão que a sua loja já usa, e mudanças maiores podem ser incompatíveis e pedem revisão antes de aplicar.

Como aplicar e revisar uma atualização do meu layout?

A atualização nunca altera o layout que está no ar. Ela cria um rascunho já na versão nova, para você revisar antes de publicar. Para aplicar, siga os passos abaixo:

1. Acessar o painel administrador da sua loja.

2. Ir em "Loja online > Layout".

3. Clicar em "Atualizar agora" no aviso de nova versão.

4. Na pop-up "Atualização disponível", ler as principais novidades que lista o que mudou nessa versão.

5. Conferir o bloco "Seu código personalizado", que informa se as suas personalizações são compatíveis com a atualização e quais arquivos entram em conflito.

6. Em seguida, clicar em "Criar rascunho".

7. Em "Rascunhos", clicar em "Editar rascunho" para revisar o resultado.

8. Quando estiver tudo certo, clicar em "Publicar".

Pronto!

A versão nova passa a ser o layout da sua loja, e o layout anterior continua disponível na lista, caso você precise voltar a ele.

Dica

Quando um arquivo for alterado pela atualização e por você, a versão nova prevalece e a sua alteração naquele arquivo é substituída. Por isso, revise o rascunho antes de publicar, principalmente se a sua loja tem código personalizado.

Perguntas frequentes

O funcionamento completo das versões, do fork e da atualização pelo terminal está na documentação para desenvolvedores da Nuvemshop.

 

Para o detalhe das versões e do algoritmo de atualização, consultar versionamento de temas seccionáveis. Para o fluxo de trabalho pela API, consultar fluxo de trabalho da API na CLI.

Não. A atualização cria um rascunho novo já na versão de destino, e o layout publicado continua exatamente como está.

 

A troca só acontece quando você revisa o rascunho e clica em "Publicar". Até lá, a sua loja segue com a versão atual.

Os arquivos que só você alterou são mantidos. Os arquivos que só a atualização alterou vêm da versão nova. Quando os dois lados alteraram o mesmo arquivo, existe um conflito, e nesse caso a versão nova prevalece.

 

A lista de arquivos em conflito aparece na janela de atualização, antes de você criar o rascunho, então é possível avaliar o impacto com antecedência.

 

O conteúdo das páginas e das seções, junto com as configurações de design, é transferido para o rascunho. Em atualizações de versão maior, quando uma mudança remove ou reformula um bloco, a atualização ajusta esse ponto específico para que a página continue funcionando.

Se o layout da sua loja não teve o código liberado para edição, ele recebe sozinho as versões intermediárias e menores, sem aviso, porque essas versões são compatíveis com a que a loja já usa.

 

Nesse caso, o aviso aparece somente quando existe uma versão maior nova. Enquanto não houver, a sua loja já está na versão mais recente da série que ela acompanha.