O WooCommerce 11.3 estava em beta em 2 de novembro de 2026. Segundo o pré-release oficial, o bloco On-Sale Badge poderá exibir o valor ou o percentual economizado, além do texto de oferta. O lançamento final foi previsto para a semana de 9 de novembro; a previsão não confirma a publicação nem garante que a versão final será idêntica à beta.
Se você vende produtos variáveis, teste uma pergunta de cada vez: o selo mostra uma economia coerente antes de selecionar uma opção? Depois de selecionar uma variação, ele passa a refletir aquela variação? Este é um checklist de exibição em staging, não um procedimento para alterar descontos na loja ativa nem uma validação do preço no checkout.
Prepare o ambiente antes de instalar a beta
- Obtenha acesso autorizado a uma cópia de staging protegida, representativa do tema, dos templates e das extensões da loja. Isole pagamentos, e-mails, webhooks, sincronização de estoque e ERP para não acionar serviços reais nem expor dados de clientes.
- Faça um backup completo e restaurável de arquivos e banco de dados antes de instalar o Beta Tester ou trocar a versão do WooCommerce, mesmo no staging. Documente como reverter a cópia; não substitua o banco de uma loja com pedidos novos pelo banco antigo do staging.
- Crie apenas produtos fictícios: um simples em promoção, outro sem promoção e um variável com pelo menos duas variações com descontos diferentes e uma sem desconto. Confira preços regulares e promocionais, datas de validade da oferta e disponibilidade de cada opção. Nosso guia de preços e estoque por variação ajuda a montar esse cenário. Ajuste a moeda de teste para BRL se isso representar sua loja.
- Identifique onde o bloco On-Sale Badge está inserido. O recurso anunciado se refere ao bloco nos templates Product Catalog e Single Product. Se o selo vier do tema clássico, de um shortcode, CSS customizado ou plugin externo de badges, este roteiro não atesta o comportamento desses componentes. Para observar a atualização após escolher uma variação na página individual, o anúncio especifica o fluxo Add to Cart + Options.
A Woo recomenda o WooCommerce Beta Tester apenas em ambiente não produtivo. O anúncio da 11.3 pede Beta Tester 4.0.0 atualizado em site com WordPress 6.8 ou mais recente — isso não é uma afirmação sobre o requisito mínimo do WooCommerce 11.3. No staging, confira a compatibilidade do seu ambiente, selecione o canal Beta e leia a build oferecida antes de atualizar. O anúncio mencionava 11.3.0-beta.1, mas outra build pode estar disponível. A atualização pelo Beta Tester substitui a instalação do WooCommerce nessa cópia.
O que conferir no On-Sale Badge do WooCommerce 11.3
Selecione o bloco no template de catálogo ou de produto individual e procure a opção Badge content → Show (a tradução e os rótulos podem variar conforme a build). O anúncio da Woo descreve três modos:
- Text: mostra “Sale” ou um texto personalizado. É o comportamento padrão; instalar a beta não ativa automaticamente o percentual.
- Amount: mostra a quantia economizada. Confira o valor e a formatação em reais no seu ambiente de teste.
- Percentage: mostra o percentual economizado. Compare-o ao preço regular e ao promocional do produto ou da variação em questão.
Amount e Percentage aceitam prefixo e sufixo. Para produtos variáveis, o pré-release descreve um selo com o maior desconto acompanhado de “Up to” antes de selecionar a variação. Em página individual com Add to Cart + Options, selecionar uma opção em promoção deve atualizar o selo; selecionar uma sem promoção deve ocultá-lo; limpar a seleção deve restaurar o máximo. Verifique o texto efetivamente apresentado, inclusive sua tradução. O anúncio não detalha todos os critérios para empates, arredondamento ou se o máximo em valor e em percentual vem da mesma variação: não deduza isso sem testar.
Checklist de teste: produtos simples e variáveis
1. Registre a linha de base
Anote a versão atual, o tema, o template, a posição do selo e eventuais personalizações. Faça capturas em desktop e celular sem dados de clientes. Depois de criar backup, atualize somente o staging para a build escolhida e confirme se o bloco continua no template esperado. A atualização segura do WooCommerce exige uma validação mais ampla do que este teste visual.
2. Compare os três modos no catálogo
No staging, escolha Text, Amount e Percentage, um por vez, salvando o template de teste. Confira a prévia do editor e a vitrine pública de staging em sessão limpa, sem uma página antiga servida pelo cache. Examine o produto simples em oferta, o simples sem oferta e o variável antes da seleção. Registre o preço regular, o preço promocional ativo e o que o selo exibe.
Um exemplo somente aritmético, não uma captura nem uma saída confirmada do plugin: variação P com preço regular de R$ 100 e promocional de R$ 80 economiza R$ 20 (20%); M, de R$ 200 por R$ 150, economiza R$ 50 (25%); G, de R$ 120 sem promoção ativa, não tem economia promocional. Confira símbolo R$, separadores e arredondamento conforme a configuração da loja. Cupons são outra mecânica: o selo deste teste não deve ser validado como se mostrasse o resultado de um cupom de desconto no WooCommerce.
3. Selecione e limpe a variação na página individual
Se o template usar Add to Cart + Options, abra o produto variável como visitante. Observe o selo sem seleção; escolha P, compare preço e economia; troque para M; selecione G, sem promoção; e, se houver controle de limpar, remova a seleção e confira o retorno do máximo. Repita em tela pequena. Se não houver esse controle ou o bloco não estiver presente, registre a limitação — não marque a etapa como aprovada por suposição. A página de catálogo não precisa oferecer a mesma interação da página individual.
| Cenário | Registre | Investigue se… |
|---|---|---|
| Simples com promoção ativa | Preços, modo do bloco, texto/valor e moeda | A economia exibida não corresponde aos preços cadastrados e ao contexto da loja. |
| Simples sem promoção | Preço e visibilidade do selo | Aparece economia onde não há oferta ativa. |
| Variável sem seleção | Preços das opções e máximo apresentado no bloco | O máximo não corresponde ao cenário de teste, depois de considerar modo e template. |
| Variação P ou M selecionada | Preço regular, promocional e selo da opção | O selo não acompanha a opção escolhida na página individual compatível. |
| Variação G sem promoção; seleção limpa | Ocultação do selo e retorno do máximo, quando houver controle para limpar | O estado não acompanha a seleção; verifique primeiro template, extensões e cache. |
Se o valor ou percentual parecer incorreto
Confirme primeiro que o preço de oferta está ativo na variação escolhida. A documentação de produtos variáveis distingue preço regular de cada variação (obrigatório) e preço promocional (opcional). Compare o mesmo produto e a mesma opção, e verifique datas de promoção, imposto, regras de preços por cliente, extensões e cache antes de atribuir o resultado à beta. Não confunda maior desconto com menor preço do catálogo.
Se o texto “Up to” ou seu equivalente traduzido não fizer sentido para seus clientes, teste prefixo e sufixo no staging e revise a comunicação em mobile. Não esconda uma diferença entre a economia máxima anunciada e a variação que o comprador pode escolher. O selo é um elemento visual; ele não comprova o valor a cobrar, nem o comportamento de carrinho, frete e checkout.
Quando considerar a atualização da loja ativa?
Não instale a beta em produção. Verifique se a versão final foi publicada e leia as notas definitivas antes de atualizar este artigo ou a loja: nomes de opções e comportamentos descritos no pré-release ainda podem mudar. Se encontrar divergência, registre a build, o tema, o template, o modo do bloco, os preços fictícios e capturas sem dados sensíveis; investigue com o fornecedor do tema/extensão ou reporte à Woo. Mesmo com o selo aprovado no staging, uma loja em operação ainda precisa de backup recente, plano de reversão e testes separados das integrações e da compra antes de receber qualquer atualização.
