{"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 atualizando uma página de produto, preparando uma campanha ou testando novos layouts. As versões e branches ajudam a gerenciar essas mudanças com segurança enquanto você colabora com sua equipe.\r\n\r\n* **[Versões](#versoes)** permitem preparar mudanças para o futuro, rastrear edições, revisar estados de conteúdo anteriores e restaurar versões mais antigas quando necessário.\r\n* **[Branches](#branches)** permitem agrupar múltiplas versões de páginas para colaborar e evoluir seu conteúdo antes de publicá-lo na vitrine.\r\n\r\n\r\n\r\nNeste guia, saiba como usar versões e branches para rastrear mudanças de conteúdo, testar com segurança, restaurar conteúdo anterior e gerenciar fluxos de publicação.\r\n\r\n## Versões\r\n\r\nAs versões mantêm um histórico de cada alteração salva em uma entrada para que você possa revisar como o conteúdo evoluiu, comparar estados anteriores e restaurar uma versão anterior quando necessário. Cada vez que você salva uma entrada na branch `main` ou em outro branch, 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 para a entrada.\r\n\r\n> ℹ️ O **Tipo de Conteúdo** funciona como um modelo (por exemplo, `Landing Page`). Uma **entrada**, como a **Landing Page** mostrada no vídeo abaixo, é uma página específica ou item de conteúdo derivado desse modelo para uma determinada loja e localidade, contendo valores únicos para seus campos (como `path`, `title` e `sections`).\r\n\r\nAs versões mostram onde a entrada existe (por exemplo, qual versão está publicada no `main` e quais branches de rascunho estão disponíveis), para que você possa alternar contextos ou criar uma nova versão em um 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 várias vantagens para o gerenciamento de conteúdo:\r\n\r\n* **Capacidade de reversão:** [Restaure rapidamente](#restaurar-versões-anteriores) uma versão publicada anteriormente para corrigir problemas como layouts quebrados ou edições incorretas. \r\n* **Rastreamento de alterações:** Mantenha um registro claro de quem fez alterações e quando, para apoiar revisões e aprovações. \r\n* **Experimentação segura:** Teste novos textos, layouts ou campanhas sem risco, sabendo que você pode reverter para a versão anterior se os resultados forem insatisfatórios. \r\n* **Reutilização de conteúdo:** Economize tempo reutilizando conteúdo de uma campanha anterior 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 eventos de ramificação e mesclagem de entradas, mostrando quem fez quais alterações e quando. Ele exibe a linha do tempo de eventos dentro da entrada selecionada, permitindo revisar estados anteriores e restaurar uma versão passada 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ê modifica uma entrada, uma nova versão é criada. Por exemplo, se fizermos uma pequena alteração no **Default page title** dentro do exemplo de **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\nApós fazer as alterações, você tem as seguintes ações disponíveis:\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, consulte 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\nOs branches facilitam a colaboração em equipe, alterações de conteúdo em massa em múltiplas páginas e fluxos de aprovação. Os branches permitem editar, revisar, visualizar e testar alterações antes de publicá-las. São comumente usados para projetos de conteúdo ou campanhas específicas, como Black Friday, ou para outras atualizações especiais de conteúdo que envolvem edição e publicação de múltiplas páginas simultaneamente.\r\n\r\n> ⚠️ **Limites de branches**: tenha em mente que cada conta pode ter até 10 branches ativos.\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 o branch `main` e outros branches\r\n\r\nO branch `main` contém o conteúdo publicado na vitrine. Quando você clica em `Salvar na main`, suas alterações são publicadas imediatamente.\r\n\r\nOutros branches são usados para desenvolver e revisar conteúdo antes de publicá-lo na `main`. Quando você clica em `Salvar na branch`, suas alterações são salvas como uma [nova versão](#criar-uma-nova-versão) dentro desse branch, sem afetar a vitrine.\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 estar em cache mesmo após a mesclagem e pode levar mais alguns minutos para aparecer na vitrine.\r\n\r\n### Excluir branch\r\n\r\nEste processo exclui todas as versões que contêm alterações dentro da branch. Entradas e outras versões de branches não serão afetadas.\r\n\r\n## Gerenciamento de remoção de conteúdo\r\n\r\nExistem três formas distintas de remover ou reverter conteúdo.\r\n\r\n### Excluir entrada\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)"}