Variação de produto não aparece no WooCommerce: corrigir

Tipo WooCommerce

Nome do erro Variação de produto não aparece no WooCommerce EN: WooCommerce product variation not showing

Severidade Atenção

Descrição A variação de produto que não aparece no WooCommerce acontece quando o produto é variável mas as opções de tamanho, cor ou modelo não surgem para o cliente escolher. Quase sempre vem de um atributo não marcado como 'Usado para variações', de variações sem preço ou estoque, ou de cache servindo uma versão antiga da página.

O que é a variação de produto que não aparece no WooCommerce?

Um produto variável no WooCommerce é aquele que tem variações, como tamanhos ou cores, cada uma com seu próprio preço, estoque e SKU. As variações aparecem em menus suspensos na página do produto. Quando elas ‘não aparecem’, os menus ficam vazios, mostram apenas ‘Selecione opções’ sem itens, ou o botão de comprar não habilita: o WooCommerce tem o produto como variável, mas não encontra variações válidas para exibir.

Como identificar

O menu suspenso de tamanho ou cor aparece vazio ou só com a opção ‘Escolha uma opção’.
A mensagem ‘Selecione opções’ nunca habilita o botão ‘Adicionar ao carrinho’, mesmo escolhendo as opções.
No editor do produto, a aba Variações está vazia ou mostra ‘Nenhuma variação encontrada para esse produto’.
As variações aparecem no admin mas não no site, ou só somem para visitantes (não para o administrador logado).

Como prevenir

Sempre marque ‘Usado para variações’ no atributo e defina preço em todas as variações antes de publicar o produto
Exclua a página de produto do cache de objeto agressivo ou limpe o cache após editar variações
Teste o produto variável como visitante anônimo após cada alteração de atributo, preço ou estoque

Causa

Atributo criado mas sem a caixa 'Usado para variações' marcada na aba Atributos do produto.
Variações geradas mas sem preço definido: o WooCommerce esconde variação sem preço do menu do cliente.
Variação marcada como fora de estoque ou com 'Gerenciar estoque' indicando quantidade zero, ficando oculta.
Cache de página ou de objeto servindo uma versão antiga da página de produto, anterior à criação das variações.
Tipo de produto salvo como 'Simples' em vez de 'Variável', ou plugin de variação (swatches/extra) conflitando com o tema.

Como resolver

Confirme o tipo de produto: no editor do produto, em Dados do produto, garanta que o tipo está como 'Produto variável'. Se estiver como 'Simples', as variações nunca aparecem para o cliente.
Marque o atributo para variações: na aba Atributos, abra o atributo (ex.: Tamanho) e marque a caixa 'Usado para variações'. Salve antes de ir para a aba Variações.
Defina preço em cada variação: na aba Variações, abra cada variação e preencha o preço. Variação sem preço é omitida do menu do cliente, deixando o dropdown vazio.
Cheque o estoque das variações: ainda em Variações, confirme que cada uma tem estoque disponível ou que 'Gerenciar estoque' não está zerado. Variação esgotada some das opções.
Limpe o cache e teste como visitante: limpe o cache de página e de objeto, e abra o produto em aba anônima. Se as variações aparecem para o admin mas não para o visitante, o cache estava servindo uma versão antiga.

PHP

// functions.php do tema filho — registra no log produtos variaveis
// que nao tem nenhuma variacao compravel (causa do dropdown vazio)
add_action( 'woocommerce_before_single_product', function () {
    global $product;
    if ( $product && $product->is_type( 'variable' ) ) {
        $available = $product->get_available_variations();
        if ( empty( $available ) ) {
            error_log( 'WooCommerce: produto variavel #' . $product->get_id() . ' sem variacoes compraveis (preco/estoque?)' );
        }
    }
} );

Perguntas frequentes

Criei as variações mas o menu aparece vazio. O que faltou?

Quase sempre falta marcar a caixa 'Usado para variações' no atributo, ou as variações estão sem preço. O WooCommerce só exibe no menu do cliente as variações que têm preço e atributo habilitado para variação. Revise os dois pontos no editor do produto.

Por que o botão de comprar não habilita mesmo escolhendo as opções?

Porque a combinação escolhida não corresponde a uma variação válida, ou a variação está sem preço ou fora de estoque. Confirme que existe uma variação cadastrada para cada combinação de atributos que você oferece ao cliente.

As variações aparecem para mim mas não para o cliente. Por quê?

Isso costuma ser cache. Como administrador você vê a página sem cache; o visitante recebe uma versão antiga, anterior à criação das variações. Limpe o cache de página e de objeto e teste em aba anônima.

Uma variação esgotada some do menu do WooCommerce?

Sim, por padrão. Variações sem estoque ficam ocultas das opções do cliente. Se quiser que ela apareça como 'Esgotado' em vez de sumir, ajuste a configuração de estoque ou reponha o inventário daquela variação.

Salvei o produto como simples por engano. Como corrigir?

No editor, em Dados do produto, troque o tipo de 'Produto simples' para 'Produto variável' e salve. Depois reabra as abas Atributos e Variações para confirmar que os atributos estão marcados para variações e que cada variação tem preço.

Um plugin de swatches pode esconder as variações?

Pode. Plugins que trocam o menu por botões de cor ou tamanho podem conflitar com o tema e não renderizar as opções. Desative o plugin de swatches temporariamente: se o menu padrão do WooCommerce voltar, o conflito é com esse plugin.

Crítico

Como corrigir pagamento do WooCommerce com erro

O pagamento do WooCommerce com erro acontece quando o cliente tenta pagar mas a transação falha, é recusada ou o pedido não é confirmado mesmo após o pagamento. Quase sempre vem de chaves de API erradas (modo teste x produção), de webhook do gateway não chegando ao site ou de SSL/HTTPS mal configurado no checkout.

Grave

Como corrigir a exibição de estoque do WooCommerce com o JetEngine

O estoque do WooCommerce aparecer errado no JetEngine significa que o Listing Grid mostra quantidade diferente da real: número desatualizado, zero em produto disponível, ou estoque que não baixa após a venda. Quase sempre vem do Dynamic Field lendo a meta _stock crua em vez do estoque oficial, ou de cache servindo valor antigo.

Atenção

Como corrigir o cálculo de frete errado no WooCommerce

O cálculo de frete errado no WooCommerce acontece quando o valor da entrega no checkout vem maior, menor ou diferente do esperado, ou simplesmente não aparece. Quase sempre vem de zonas de entrega mal configuradas, de produtos sem peso e dimensões, ou de classes de frete e regras de frete grátis conflitando entre si.

Crítico

Como corrigir erro de pagamento do Tutor LMS com WooCommerce

O erro de pagamento do Tutor LMS com WooCommerce ocorre quando o aluno compra um curso, o pedido entra no WooCommerce, mas a matricula não acontece e ele fica sem acesso. A causa quase sempre e o pedido não atingir o status Concluido, o produto do curso não ser virtual, ou a engine de monetizacao errada nas Configurações.

Grave

Como corrigir carrinho do WooCommerce que esvazia sozinho

O carrinho do WooCommerce que esvazia sozinho acontece quando os itens adicionados desaparecem antes do checkout, derrubando a conversão. A causa quase sempre é cache servindo a página do carrinho em vez de ignorá-la, ou a sessão/cookie do cliente sendo perdida entre as requisições.

Grave

Como corrigir o produto do WooCommerce com página em branco

O produto do WooCommerce com página em branco acontece quando a página de um produto abre totalmente vazia, sem texto, imagem ou botão de comprar. A causa quase sempre é um erro fatal de PHP silenciado, um template de produto ausente no tema, ou o limite de memória do PHP estourado ao renderizar a página.

Setores

Extensões

Integrações

Como corrigir a variação de produto que não aparece no WooCommerce

O que é a variação de produto que não aparece no WooCommerce?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir pagamento do WooCommerce com erro

Como corrigir a exibição de estoque do WooCommerce com o JetEngine

Como corrigir o cálculo de frete errado no WooCommerce

Como corrigir erro de pagamento do Tutor LMS com WooCommerce

Como corrigir carrinho do WooCommerce que esvazia sozinho

Como corrigir o produto do WooCommerce com página em branco

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos