Veja as boas práticas para editar o código-fonte do layout de uma loja, como configurar a ferramenta, quais cuidados tomar com backup e o que muda nas atualizações.
Última atualização: 18/09/2026
A Nuvemshop tem vários modelos gratuitos na Loja de Layout, que permitem montar uma loja profissional sem editar código.
Para negócios com necessidades mais específicas, parceiros, profissionais de desenvolvimento e clientes com conhecimento em programação podem acessar o código-fonte do layout e personalizar a loja com uma identidade visual exclusiva.
Aqui reunimos as boas práticas e os cuidados desse trabalho.
A ferramenta indicada nos dois caminhos é a CLI da Nuvemshop. Ela sincroniza as alterações enquanto você edita, gera link de pré-visualização, mostra o que muda antes de enviar e dispensa um cliente FTP de terceiros.
Para saber como utilizar CLI da Nuvemshop na loja, acessar: Como instalar e usar a CLI da Nuvemshop para editar layouts?
Com o Nuvemshop CLI, a agência não precisa mais utilizar programas como FileZilla ou Cyberduck. Tudo acontece direto no editor de código (como o VS Code) e no terminal.
O caminho depende do tipo de layout instalado na loja.
Para mais detalhes de cada caminho, acessar: Como editar o código do layout da minha loja?
O código-fonte de uma loja em operação é um ambiente de produção, então vale tratar cada alteração com o mesmo cuidado que você aplicaria em qualquer projeto no ar.
Mantenha um backup próprio dos arquivos originais. Baixe todos os arquivos antes da primeira alteração e guarde essa cópia do seu lado, atualizada conforme o projeto avança.
O nosso time técnico não consegue recuperar os arquivos personalizados em todas as situações, e a Nuvemshop não guarda backup de layout personalizado. O backup do seu lado é o que garante a possibilidade de restaurar o trabalho.
Combine com o cliente quem aplica as atualizações. Depois que o código é liberado, manter o layout atualizado passa a depender de alguém com conhecimento em programação, e vale deixar isso claro no escopo do projeto.
Para mais informações sobre as atualizações disponibilizados para o layout e como aplicar as versões novas em um layout com fork, consultar como testar as atualizações do meu layout na Nuvemshop sem perder as personalizações.
A documentação para criação e manutenção de layout personalizado fica no nosso portal para desenvolvedores, com a referência dos arquivos, dos objetos e das boas práticas de código. Veja abaixo:
A documentação é escrita a partir do nosso layout base, então podem existir diferenças de estrutura no código em relação aos outros modelos de layout.
Para saber o que é possível alterar pelo código-fonte, consultar as perguntas frequentes sobre alterações no layout via FTP.