{"section":"tutorials","requestedLocale":"pt","requestedSlug":"gerenciando-versoes-e-branches","locale":"pt","slug":"gerenciando-versoes-e-branches","path":"docs/pt/tutorials/cms/branching-and-versioning/gerenciando-versoes-e-branches.md","branch":"main","content":"Ao trabalhar com conteúdo no CMS, as alterações ocorrem com frequência, seja ao atualizar uma página de produto, preparar uma campanha ou testar novos layouts. Versões e branches ajudam você a gerenciar essas alterações com segurança enquanto colabora com sua equipe. \r\n\r\n* As **[versões](#versoes)** permitem preparar alterações para o futuro, rastrear edições, revisar estados anteriores do conteúdo e restaurar versões anteriores quando necessário. \r\n* As **[branches](#branches)** permitem agrupar várias versões de página para colaborar e evoluir o conteúdo antes de publicar no storefront. \r\n\r\n\r\n\r\nNeste guia, você aprenderá a usar versões e branches para rastrear alterações de conteúdo, testar com segurança, restaurar versões anteriores e gerenciar fluxos de publicação.\r\n\r\n## Versões\r\n\r\nVersões mantêm um histórico de cada alteração salva em um cadastro, permitindo revisar como o conteúdo evoluiu, comparar estados anteriores e restaurar uma versão anterior quando necessário. Cada vez que você salva um cadastro na branch `main` ou em outro, o CMS armazena uma nova versão no histórico de versões, junto com o nome do usuário que fez a alteração e a data. Com o tempo, isso cria um histórico de versões do cadastro. \r\n\r\n> ℹ️ O **tipo de conteúdo** serve como um template (por exemplo, `landing page`). Uma **entrada**, como a **landing page** mostrada no vídeo abaixo, é uma página ou item de conteúdo específico derivado desse template para uma determinada loja e localidade, contendo valores únicos em seus campos (como `path`, `title` e `sections`). \r\n\r\nAs versões mostram onde o cadastro está (por exemplo, qual versão está publicada na `main` e quais branches de rascunho estão disponíveis); assim, você pode alternar o contexto ou criar uma nova versão em uma branch.\r\n\r\n![versions-modal](https://vtexhelp.vtexassets.com/assets/docs/src/cms-versions-pt___591efa3837cf849b9cbfd8af7044b934.png)\r\n\r\nO controle de versões oferece diversas vantagens para o gerenciamento de conteúdo:\r\n\r\n* **Capacidade de rollback:** permite [restaurar rapidamente uma versão publicada anteriormente](#restaurar-versões-anteriores) para corrigir problemas, como layouts quebrados ou edições incorretas.\r\n* **Monitoramento de alterações:** mantém um registro claro de quem fez as alterações e quando, facilitando avaliações e aprovações.\r\n* **Experimentação segura:** teste novos textos, layouts ou campanhas sem riscos, sabendo que você pode voltar à versão anterior caso os resultados não sejam satisfatórios. \r\n* **Reutilização de conteúdo:** ganhe tempo reutilizando conteúdos de campanhas anteriores em vez de começar do zero.\r\n\r\n### Histórico de versões\r\n\r\nO histórico de versões registra os eventos de ramificação e merge das entradas, mostrando quem fez cada alteração e quando. Ele exibe a linha do tempo de eventos na entrada selecionada, permitindo revisar estados anteriores e restaurar uma versão anterior quando necessário.\r\n\r\n![version-history-modal](https://vtexhelp.vtexassets.com/assets/docs/src/cms-version-history-pt___60bb41d1604aafb647df4e5e85c9bc05.png)\r\n\r\n### Criar uma nova versão\r\n\r\nSempre que você altera uma entrada, uma nova versão é criada. Por exemplo, se fizermos uma pequena alteração no **título da página padrão** na **landing page** abaixo, o CMS gera uma nova versão:\r\n\r\n![creating-a-new-version](https://vtexhelp.vtexassets.com/assets/docs/src/cms-creating-version-pt___3f26025b18b9f06af3f2d4f13ed55f1a.gif)\r\n\r\nDepois de realizar as alterações, você pode escolher entre as seguintes ações:\r\n\r\n| Ação | Descrição |\r\n| :---- | :---- |\r\n| `Salvar na main` | Salva suas edições atuais diretamente na branch `main`, atualizando a versão publicada dessa entrada e atualizando a vitrine visível para os Compradores. |\r\n| `Salvar na branch` | Salva suas edições como uma nova versão apenas na branch selecionado (por exemplo, `black-friday`), mantendo o branch `main` inalterado. Use isso para trabalhar em rascunhos ou campanhas sem afetar o que está publicado na vitrine. |\r\n| `Descartar` | Exclui todas as alterações não salvas no formulário e restaura a entrada para sua última versão salva no `main` ou em outro branch, sem criar uma nova versão. Esta ação não pode ser desfeita. |\r\n\r\n> ℹ️ Para mais informações sobre branches, acesse a seção [Branches](#branches).\r\n\r\n### Restaurar versões anteriores\r\n\r\nAs versões salvas na branch `main` podem ser visualizadas e restauradas para publicar conteúdo do passado. No painel de Histórico de versões, ao passar o cursor sobre uma versão publicada anteriormente, é exibida a ação **Ver versão**.\r\n\r\n![restore-past-versions](https://vtexhelp.vtexassets.com/assets/docs/src/restore-versions-pt___4a13ed35567902a81081448e5c0e09ef.png)\r\n\r\nApós visualizar, você pode escolher entre as seguintes ações:\r\n\r\n| Ação | Descrição |\r\n| :---- | :---- |\r\n| `Restaurar na main` | Duplica a versão e a publica na branch `main` como uma nova versão na vitrine. |\r\n| `Restaurar na branch` | Duplica a versão e a adiciona a um branch de destino para edição adicional, sem impactar a vitrine. |\r\n| `Fechar` | Fecha a versão anterior e retorna ao branch `main` sem aplicar nenhuma restauração. |\r\n\r\n> ℹ️ Para mais informações sobre branches, consulte a seção [Branches](#branches).\r\n\r\n## Branches\r\n\r\nBranches facilitam a colaboração em equipe, alterações em massa de conteúdo em múltiplas páginas e fluxos de aprovação. Elas permitem que você edite, avalie, pré-visualize e teste alterações antes de publicá-las. As branches são usadas comumente em projetos ou campanhas específicas de conteúdo, como a Black Friday, ou em outras atualizações especiais que envolvem a edição e a publicação de várias páginas simultaneamente.\r\n\r\n> ⚠️ **Limites de branches**: lembre-se que cada conta pode ter até 10 branches ativas.\r\n\r\n![branches-overview](https://vtexhelp.vtexassets.com/assets/docs/src/branch-overview-pt___b39313c4040dec56574d85d599184d93.png)\r\n\r\n| Funcionalidade | Descrição |\r\n| :---- | :---- |\r\n| **Branches (`+`)** | Lista todos os branches da loja. Use o **`+`** para criar um novo branch. |\r\n| **Busca** | Encontra entradas por nome dentro da branch e loja atuais. |\r\n| **Filtro por tipo de conteúdo** | Filtra a lista de entradas por tipo de conteúdo (por exemplo, `home`, `pdp`, `landingPage`). |\r\n| **Filtro de última atualização** | Ordena ou filtra entradas pelo tempo de atualização mais recente. |\r\n| **Tabela de entradas** | Exibe as entradas na branch, incluindo informações de **Nome**, **Tipo de Conteúdo**, **Loja** e **Última atualização**. |\r\n| **Mostrar apenas alterações** | Filtra a lista para mostrar apenas entradas modificadas na branch ativo. |\r\n| **Ícone de paginação** | Navega entre páginas de entradas. |\r\n| **Criar conteúdo** | Cria uma nova entrada na branch e loja atuais. |\r\n| **Pré-visualização** (ícone de olho) | Abre uma pré-visualização para revisar o conteúdo de rascunho na vitrine. |\r\n| **Mergear** | Mescla as alterações da branch no `main`, imediatamente ou em uma data agendada. Para mais detalhes, consulte [Publicar e agendar alterações](#publicar-e-agendar-alterações). |\r\n\r\n### Entendendo a branch `main` e as demais branches**\r\n\r\nA branch `main` contém o conteúdo publicado no storefront. Ao clicar em `Salvar na Main`, suas alterações são publicadas imediatamente. \r\n\r\nAs demais branches são usadas para desenvolver e revisar o conteúdo antes da publicação na main. Ao clicar em `Salvar na branch`, suas alterações são salvas como uma nova versão dentro dessa branch, sem impactar o storefront.\r\n\r\n### Publicar e agendar alterações\r\n\r\nA página de **Branches** inclui a capacidade de `Mergear` o branch atual com o branch `main`, oferecendo duas formas de publicar conteúdo na vitrine:\r\n\r\n* `Mergear agora` pega as alterações contidas na branch e as mescla na branch `main`. Esta ação publica as alterações imediatamente na vitrine.\r\n\r\n* `Agendar merge` permite planejar a mesclagem de um branch na branch main para uma data e hora futuras. O CMS executará automaticamente a mesclagem assim que a data e hora agendadas chegarem.\r\n\r\n![publish-and-schedule-changes](https://vtexhelp.vtexassets.com/assets/docs/src/merge-schedule-pt___46148bf41908dd2a2d9842237174cb9f.gif)\r\n\r\n> ⚠️ O conteúdo pode permanecer em cache mesmo após o merge e pode levar alguns minutos a mais para aparecer no storefront.\r\n\r\n### Excluir branch\r\n\r\nEsse processo exclui todas as versões que tenham alterações dentro da branch. As entradas e outras versões em outras branches não serão afetadas.\r\n\r\n## Gerenciar remoção de conteúdo\r\n\r\nExistem três formas distintas de remover ou reverter conteúdo.\r\n\r\n### Excluir entradas\r\n\r\nExclui a entrada inteira e todas as suas versões. Esta ação é irreversível. Para excluir uma entrada, siga estes passos:\r\n\r\n1. Escolha uma das entradas de um branch que você criou, por exemplo, **Home**. \r\n2. Em **Home**, clique no menu e escolha `Excluir`. \r\n3. Clique em `Segure para excluir`, e a entrada será excluída. \r\n\r\n ![delete-entry](https://vtexhelp.vtexassets.com/assets/docs/src/delete-entry-pt___1de60b59f60f7c3e1db7fcb242a3a859.gif)\r\n\r\n### Desfazer alterações\r\n\r\nDescarta suas alterações em um branch e restaura a entrada para sua última versão publicada.\r\n\r\n![undo-changes](https://vtexhelp.vtexassets.com/assets/docs/src/undo-changes-pt___021dac72f282e4b9209ca08d52e907a3.png)\r\n\r\n### Excluir da `main`\r\n\r\nRemove a entrada da branch `main` mantendo as versões em outros branches. Isso cancela a publicação do conteúdo na vitrine.\r\n\r\n![delete-from-main](https://vtexhelp.vtexassets.com/assets/docs/src/delete-from-main-pt___18c247ceaee82219b1aebddd28c6cb39.png)"}