O que é code freeze em e-commerce e por que ele vale para a loja Magento

Code freeze é um acordo com data: a partir de um dia, nada de código novo sobe para a loja, salvo exceção prevista. A ideia é que a semana de maior venda rode sobre uma versão que já passou por pedidos reais, e não sobre a entrega da véspera.

No Magento, deploy mexe em mais coisa do que arquivo. O setup:upgrade aplica patches no banco, a compilação regenera classes e o deploy de estáticos refaz CSS e JavaScript. Um erro nessa sequência pode tirar a loja do ar, e desfazer mudança de banco não é tão rápido quanto voltar um arquivo.

A própria Adobe leva isso em conta: no calendário oficial de patches de 2026, atualizado em 19/08/2026, as datas de 10/11 e 08/12 aparecem como liberação opcional, com a justificativa de congelamento de código de fim de ano.

Calendário de deploy de novembro de 2026, de trás para a frente

As datas abaixo são a recomendação que eu faço, com o motivo de cada uma. Ajuste ao tamanho da sua equipe, mas mantenha a ordem.

DataMarcoPor quê
Terça, 27/10Combinar o calendário com dev e marketing e listar o que ainda precisa entrarFuncionalidade que não começou até aqui dificilmente fica pronta e testada a tempo
Sexta, 06/11Último deploy de funcionalidade nova, extensão nova ou atualização de extensãoTrês semanas de pedidos reais mostram o que o staging não mostra: pagamento, frete, e-mail e integração com dados de verdade
09/11 a 19/11Só correções, homologadas no staging, com deploy em dia útil e pela manhãQuem sobe de manhã tem o dia inteiro para observar a loja
Sexta, 20/11Sem deployFeriado nacional do Dia Nacional de Zumbi e da Consciência Negra (Lei 14.759/2023), com equipe reduzida a uma semana do pico
23/11 a 01/12Congelamento total: só hotfix, pelo critério da próxima seçãoCobre a semana da Black Friday (27/11), o fim de semana, a Cyber Monday (30/11) e um dia de observação
Quarta, 02/12Liberação, começando pelos itens menores que ficaram represadosSubir tudo junto no primeiro dia recria o risco que o congelamento evitou

Para o período de correções funcionar, a loja precisa de um lugar para testar antes. Se ainda não tem, o checklist de staging é o primeiro item da lista de 27/10.

O que conta como hotfix durante o congelamento

Hotfix precisa de critério escrito antes do congelamento, e não de discussão no meio da madrugada. O que eu uso: entra só o que cumpre as três condições.

  1. Impacto: impede ou corrompe finalizar compra, pagar, calcular frete ou registrar o pedido, ou é falha de segurança.
  2. Evidência: número de pedido ou SKU, horário, mensagem de erro ou print, e o erro reproduzido no staging.
  3. Aprovação: uma pessoa nomeada da loja (dono ou gestor) aprova por escrito, e o dev informa como voltar à versão anterior se a correção falhar.

Não entra: ajuste de layout, troca de texto que dependa de template, melhoria de desempenho, atualização de extensão sem falha de segurança e qualquer funcionalidade pedida na semana. Tudo isso vai para uma lista com data de 02/12.

E os patches de segurança da Adobe?

O mesmo calendário da Adobe marca um arquivo de patch de segurança isolado em 13/10/2026, para as linhas 2.4.4 a 2.4.9. A página avisa que o patch isolado só pode ser aplicado sobre a última versão -p da linha. Por isso a atualização para o último -p e o patch de outubro entram antes de 06/11. Se sair uma correção de emergência durante o congelamento, leia o boletim de segurança: falha crítica que afeta a sua versão vira hotfix, aplicado primeiro no staging; o restante espera 02/12.

Banner e conteúdo do CMS também congelam?

Depende do que muda. Eu separo em três grupos:

Tipo de mudançaNo congelamento
Código: módulo, tema, extensão, ComposerCongelado, salvo hotfix
Configuração em Stores > Configuration: pagamento, frete, impostos, checkoutTratada como código, porque um campo desliga um meio de pagamento
Conteúdo: banner em bloco de CMS, página, regra de preço, cupomLiberado, com preparo e revisão antes

Duas regras para o conteúdo. A primeira: campanha se agenda, não se edita ao vivo. No Magento Open Source, a regra de carrinho tem campos de data de início e fim; no Adobe Commerce, o Content Staging agenda mudanças em produtos, categorias, regras de preço, páginas e blocos de CMS. A segunda: ninguém limpa o cache inteiro em horário de pico. Numa loja com Varnish, o código do módulo CacheInvalidate faz os botões Flush Magento Cache e Flush Cache Storage da tela Cache Management mandarem o Varnish esvaziar todo o cache de página, e cada página volta a ser montada pelo PHP justamente com a loja cheia.

Modelo de mensagem para combinar o congelamento

Mande por escrito, para dev, agência e marketing no mesmo e-mail:

Calendário da Black Friday 2026. Até 06/11: último deploy de funcionalidade e de extensão. De 09/11 a 19/11: só correções homologadas no staging, em dia útil, pela manhã. 20/11: sem deploy. De 23/11 a 01/12: congelamento total; hotfix só com impacto em compra, pagamento, frete ou segurança, evidência e aprovação de [nome do aprovador]. Conteúdo de CMS e promoções: preparados até 20/11 e agendados, sem limpeza geral de cache. Liberação a partir de 02/12.

Troque o nome do aprovador antes de enviar. Para adaptar as datas à rotina da sua loja, fale comigo.

Perguntas frequentes

Marketing pediu banner novo no meio do congelamento, pode?

Pode, se for conteúdo e não código: bloco ou página de CMS preparado e revisado antes, publicado fora do horário de pico e sem limpar todo o cache da loja. Banner que exige template novo, JavaScript ou módulo é código e fica para depois da liberação, em 02/12.

Posso atualizar extensão em novembro?

Até o último deploy de funcionalidade, em 06/11, sim, com teste no staging. Depois disso, atualização de extensão só entra como hotfix, quando corrige falha de segurança ou erro que impede compra, pagamento ou frete. Versão nova só com melhorias espera o fim do congelamento.

E se sair patch de segurança durante o congelamento?

Leia o boletim de segurança da Adobe. Se a falha for crítica e afetar a sua versão, trate como hotfix: aplique primeiro no staging e suba em horário de baixo movimento, com plano de volta. Se não for, agende para 02/12. Deixar a loja no último patch antes de 06/11 diminui esse risco.

Fontes oficiais

  1. Patch release schedule (calendário de 2026) (Adobe Experience League)
  2. Lei nº 14.759, de 21 de dezembro de 2023 (feriado de 20 de novembro) (Presidência da República)
  3. Content Staging (Adobe Experience League)
  4. Create a cart price rule (datas From e To) (Adobe Experience League)
  5. Cache management (Adobe Experience League)
  6. Magento_CacheInvalidate events.xml no 2.4.9 (Magento no GitHub)

Outros artigos

Ver todos os artigos

Precisa de um orçamento? Ficarei feliz em ajudar. Clique aqui