O botão "Adicionar ao carrinho" do WooCommerce não está funcionando: como resolver?

O botão "Adicionar ao carrinho" do WooCommerce é o elemento mais importante em qualquer página de produto. Quando ele para de funcionar, sua loja não consegue processar pedidos. Cada visitante que acessa uma página de produto com defeito representa uma venda perdida.

Um relatório do Baymard Institute revelou que 17% dos compradores online abandonam suas compras devido a erros no site. Um botão "Adicionar ao carrinho" quebrado ou ausente se enquadra perfeitamente nessa categoria e afeta 100% dos visitantes da sua página de produto, não apenas uma fração.

A solução depende do tipo específico de falha. Um botão que não está visível tem causas diferentes de um botão que aparece, mas não faz nada ao ser clicado, ou de um botão que adiciona um item ao carrinho, mas a página não atualiza. Diagnosticar qual falha você está enfrentando determina qual solução aplicar primeiro.

Este guia aborda todas as causas e soluções, ordenadas por ordem de prioridade de resolução dos problemas.

Primeiro, diagnostique o tipo de falha

Nem todos os problemas com o botão "Adicionar ao carrinho" são iguais. A solução depende do tipo de falha que você está enfrentando.

Tipo de falha	O que você vê	Causa mais provável
Botão não aparece	A página do produto carrega, mas nenhum botão aparece	Dados do produto ausentes, configurações de produto fora de estoque e problema com o tema
Botão não clicável	O botão aparece, mas nada acontece ao clicar nele	Erro de JavaScript, conflito de tema, scripts bloqueados por plugins
O botão é adicionado, mas a página não atualiza	O indicador de carregamento aparece e para, mas a contagem de carrinhos permanece inalterada	O AJAX está sendo bloqueado pelo cache ou por um plugin de segurança
O botão redireciona incorretamente	O clique leva o cliente para a página errada	Configuração incorreta do link permanente, página do carrinho não atribuída
O botão funciona em alguns produtos, mas não em outros	A questão é específica do produto	Dados incompletos do produto, configuração incorreta de variáveis ​​do produto

Identifique o tipo de falha usando esta tabela e, em seguida, comece com a solução mais adequada à sua situação específica.

Três tipos de falhas no botão "Adicionar ao carrinho" do WooCommerce

Aplicar a solução errada desperdiça tempo e pode causar novos problemas. Identifique qual tipo de falha corresponde ao que você está observando antes de prosseguir com as soluções abaixo.

O botão não está aparecendo

Quando o botão "Adicionar ao carrinho" está completamente ausente da página de um produto, o WooCommerce está ocultando-o intencionalmente ou o tema não o está renderizando.

O WooCommerce oculta automaticamente o botão "Adicionar ao carrinho" nestes cenários:

• O produto não tem preço definido

• O produto está marcado como fora de estoque e a configuração da loja para ocultar produtos fora de estoque está ativada

• Um produto variável não possui variações configuradas ou todas as variações estão fora de estoque

• Um produto externo/afiliado não possui URL externa configurada

Verifique estas configurações do produto antes de presumir um problema técnico. Acesse a página de edição do seu produto no WooCommerce e verifique se o painel de Dados do Produto exibe um preço, se o status do estoque está como "Em estoque" ou se a configuração de "Fora de estoque" está correta e, para produtos variáveis, se existe pelo menos uma variação disponível em estoque.

O botão está visível, mas não é clicável

Quando o botão aparece, mas não responde aos cliques, um erro de JavaScript está impedindo que o manipulador de cliques seja acionado. O botão é renderizado em HTML, mas sua funcionalidade está comprometida devido a um conflito ou erro de script.

Abra o console do desenvolvedor do seu navegador (F12 no Chrome e, em seguida, a guia Console) e recarregue a página do produto. Clique no botão Adicionar ao carrinho e procure mensagens de erro em vermelho no console. Erros comuns de JavaScript que indicam a causa específica:

• jQuery não está definido: o jQuery não está carregando ou está carregando fora de ordem. Isso geralmente é causado por plugins de otimização que adiam o carregamento do jQuery.

• Não é possível ler a propriedade de undefined: Uma função JavaScript do WooCommerce está sendo executada antes que sua dependência esteja pronta. Geralmente isso é causado por um conflito de plugins.

• URL AJAX não definida / wc_add_to_cart_params não está definido: os parâmetros do carrinho do WooCommerce não estão sendo exibidos na página. Geralmente, isso ocorre quando um plugin de cache exibe uma versão em cache da página sem o JavaScript do WooCommerce.

Anote o erro específico antes de prosseguir. Ele indica exatamente qual correção aplicar.

O botão é clicado, mas o carrinho não é atualizado

Quando o botão parece funcionar (o clique é registrado e um indicador de carregamento pode aparecer), mas a contagem do carrinho não é atualizada e o produto não é adicionado, a solicitação AJAX está falhando. O WooCommerce usa AJAX para adicionar produtos ao carrinho sem recarregar a página. Quando o AJAX é bloqueado ou falha, o clique parece não ter efeito algum.

Isso geralmente é causado por plugins de cache que fornecem respostas em cache para solicitações AJAX, plugins de segurança que bloqueiam chamadas AJAX classificadas como suspeitas ou configuração incorreta de URLs AJAX nas configurações do WooCommerce.

 

Solução 1: Atualize o WooCommerce, o WordPress e todos os plugins

O software desatualizado é o problema mais fácil de descartar e o mais frequentemente ignorado. Comece por aqui antes de qualquer outra solução, especialmente se o botão parou de funcionar após uma atualização recente.

Por que um software desatualizado impede o funcionamento do botão "Adicionar ao carrinho"?

O WooCommerce, o WordPress, os temas e os plugins são atualizados com frequência. Quando um componente é atualizado e os outros não acompanham o ritmo, surgem incompatibilidades. O botão "Adicionar ao carrinho" depende de uma cadeia de componentes que funcionam em conjunto: o núcleo do WordPress, o WooCommerce, o tema ativo e quaisquer plugins que modifiquem o comportamento do produto ou do carrinho. Uma incompatibilidade de versão em qualquer ponto dessa cadeia a interrompe.

Essa é a causa mais comum para o botão "Adicionar ao carrinho" parar de funcionar imediatamente após qualquer atualização. Se o seu botão funcionava e parou de funcionar depois de uma atualização recente, é quase certo que a causa seja um problema de compatibilidade.

Como atualizar tudo com segurança

Antes de atualizar, faça um backup. Acesse Painel > Atualizações no painel de administração do WordPress. Primeiro, atualize o núcleo do WordPress. Em seguida, atualize todos os plugins. Depois, atualize o seu tema.

Especificamente para o WooCommerce, as atualizações de versão principais (4.x para 5.x, 5.x para 6.x) às vezes introduzem alterações que quebram a compatibilidade. Sempre teste as atualizações principais do WooCommerce em um ambiente de teste antes de aplicá-las em produção.

Após a atualização, limpe o cache do seu site, caso utilize um plugin de cache. Em seguida, teste o botão "Adicionar ao carrinho" na página do produto antes de considerar o problema resolvido.

O que fazer se o botão quebrar após uma atualização?

Se o botão parou de funcionar imediatamente após uma atualização específica, essa atualização é a causa mais provável. Reverta para a versão anterior usando o plugin WP Rollback ou restaure seu backup anterior à atualização. Em seguida, verifique o changelog do plugin e o fórum de suporte para relatos do mesmo problema antes de atualizar novamente.

Correção 2: Resolver conflitos entre plugins e temas

Conflitos entre plugins e temas são a causa mais comum de um botão "Adicionar ao carrinho" não funcionar. Siga estes passos na ordem indicada, testando após cada um antes de prosseguir para a próxima solução.

Como identificar um conflito de plugins

Conflitos entre plugins são a causa mais comum de um botão "Adicionar ao carrinho" não funcionar. A maneira mais rápida de identificar um conflito de plugins é desativar todos os plugins, exceto o WooCommerce, e testar o botão.

Acesse Plugins > Plugins instalados. Selecione todos os plugins, exceto o WooCommerce. Escolha Desativar no menu suspenso de ações em massa. Aplique.

Teste o botão "Adicionar ao carrinho". Se agora funcionar, um plugin desativado era a causa do problema. Reative os plugins um de cada vez, testando o botão após cada reativação. Quando o botão parar de funcionar novamente, o plugin reativado mais recentemente é o que está causando o conflito.

Se não for possível desativar todos os plugins em uma loja em produção, utilize um ambiente de teste para replicar este teste.

Plugins comuns que entram em conflito com o botão "Adicionar ao carrinho"

Determinadas categorias de plugins são responsáveis ​​pela maioria dos conflitos do botão "Adicionar ao carrinho":

Plugins de cache: WP Rocket, W3 Total Cache, WP Super Cache. Esses plugins podem armazenar em cache o JavaScript do WooCommerce de maneiras que quebram a funcionalidade AJAX. Solução: Exclua as páginas do WooCommerce do cache. No WP Rocket, as páginas do WooCommerce (carrinho, finalização da compra, minha conta) são excluídas automaticamente, mas verifique isso em WP Rocket > Configurações > Cache > Nunca armazenar em cache estas URLs.

Plugins de otimização: Autoptimize, Perfmatters, Asset CleanUp. Esses plugins minificam e combinam arquivos JavaScript. A combinação incorreta de scripts do WooCommerce com outros scripts causa erros de dependência do jQuery. Solução: No Autoptimize, acesse Configurações > Opções de JavaScript e habilite a opção "Forçar JavaScript no cabeçalho?". Marque a opção "Excluir scripts do Autoptimize" e adicione woocommerce.js e add-to-cart.js à lista de exclusão.

Plugins de segurança: Wordfence, Sucuri, iThemes Security. Algumas configurações de segurança bloqueiam as requisições AJAX do WooCommerce, classificando-as como maliciosas. Solução: No Wordfence, acesse Firewall > Opções do Firewall e adicione o endpoint AJAX do WooCommerce (wp-admin/admin-ajax.php) à lista de permissões.

Construtores de páginas: Elementor, Divi, WPBakery. Alguns construtores de páginas sobrescrevem os modelos do WooCommerce ou injetam scripts conflitantes nas páginas de produtos. Solução: Teste alternando temporariamente para o modelo de produto padrão do WooCommerce.

Como identificar um conflito temático

Após descartar conflitos de plugins, mude para o tema Storefront (o tema padrão oficial do WooCommerce) e teste o botão. O Storefront foi desenvolvido especificamente para o WooCommerce e não apresenta problemas de compatibilidade.

Acesse Aparência > Temas > Adicionar novo e procure por Storefront. Instale e ative o tema. Não altere nenhuma outra configuração. Teste o botão Adicionar ao carrinho.

Se o botão funcionar com o Storefront, o problema está no seu tema ativo. Entre em contato com o desenvolvedor do seu tema e relate o problema. Se não funcionar com o Storefront, a causa não está relacionada ao tema.

Correção 3: Corrigir erros de JavaScript e AJAX

Falhas em JavaScript e AJAX fazem com que o botão apareça quebrado mesmo quando todo o resto está configurado corretamente. Verifique primeiro o console do navegador para ver qual script está falhando antes de fazer qualquer alteração.

Como verificar erros de JavaScript no seu navegador

Abra seu site no Chrome ou Firefox. Pressione F12 para abrir as Ferramentas do Desenvolvedor. Clique na aba Console. Navegue até a página de um produto onde o botão Adicionar ao Carrinho está com defeito.

Procure por mensagens de erro em vermelho. Essas são as falhas específicas de JavaScript que estão causando o mau funcionamento do botão. Copie a mensagem de erro completa. Procure por ela nos de suporte do WooCommerce e no fórum de suporte do próprio plugin. A maioria dos erros comuns possui soluções documentadas.

Com o Console aberto, verifique também a aba Rede. Clique no botão Adicionar ao Carrinho e observe as requisições. Uma requisição AJAX com falha aparece em vermelho com um código de status. Um status 403 indica que um plugin de segurança está bloqueando a requisição. Um status 500 indica um erro no servidor no manipulador AJAX.

Corrigir configurações de AJAX para adicionar ao carrinho no WooCommerce

Acesse WooCommerce > Configurações > Produtos. Procure a seção Comportamento do Adicionar ao Carrinho. Verifique se a opção Ativar botões AJAX para adicionar ao carrinho em páginas arquivadas está marcada. Essa configuração controla se a funcionalidade de carrinho AJAX está ativa nas páginas da loja e de categorias.

Verifique também se as páginas do carrinho e de finalização da compra estão configuradas corretamente. Acesse WooCommerce > Configurações > Avançado > Configuração da página. Confirme se as páginas do carrinho e de finalização da compra estão definidas para as páginas corretas do seu site. Se alguma delas estiver em branco ou configurada para a página errada, os cliques no botão do carrinho falharão silenciosamente.

Corrigir problemas com plugins de otimização que quebram scripts do WooCommerce

Se um plugin de otimização estiver minificando ou combinando JavaScript e causando problemas no WooCommerce, adicione os seguintes scripts à lista de exclusões do plugin:

Scripts a serem excluídos da minificação:

• woocommerce/assets/js/frontend/woocommerce.min.js

• woocommerce/assets/js/frontend/add-to-cart.min.js

• woocommerce/assets/js/frontend/add-to-cart-variation.min.js

• jquery.js ou jquery.min.js

Além disso, exclua as páginas do WooCommerce da otimização de JavaScript: carrinho (/cart/), finalização da compra (/checkout/), minha conta (/my-account/) e todas as páginas de produtos (/product/).

No WP Rocket: Acesse Otimização de Arquivos > Arquivos JavaScript. Adicione as exclusões acima ao campo Arquivos JavaScript Excluídos.

No Autoptimize: Acesse Opções de JavaScript > Excluir scripts do Autoptimize e adicione os caminhos dos scripts do WooCommerce.

Solução 4: Verifique e complete as informações do seu produto

O WooCommerce desativa silenciosamente o botão "Adicionar ao carrinho" quando faltam dados obrigatórios do produto. Se o botão estiver ausente em produtos específicos, mas funcionar em outros, comece por aqui.

Campos obrigatórios que acionam o botão ausente

O WooCommerce exige dados específicos do produto para exibir o botão "Adicionar ao carrinho". Se algum campo obrigatório estiver faltando, o WooCommerce desativa o botão silenciosamente, sem exibir uma mensagem de erro.

Verifique todos os produtos onde o botão está faltando:

• Preço: Todo produto deve ter um preço normal definido. Um produto sem preço não exibirá o botão "Adicionar ao carrinho". Acesse Produto > Dados do produto > Geral e verifique se o campo "Preço normal" contém um valor.

• Nome do produto: O produto deve ter um título. Raramente falta um título, mas vale a pena confirmar em rascunhos recém-criados.

• Visibilidade: Certifique-se de que a Visibilidade do Catálogo do produto esteja definida como Loja e resultados de pesquisa ou Loja. Produtos definidos como Ocultos não exibem o botão nas páginas de arquivo.

• Status do produto: Confirme se o produto foi publicado e não está em rascunho ou pendente de revisão.

Configuração variável do produto para adicionar ao carrinho

Os produtos variáveis ​​comportam-se de forma diferente dos produtos simples. Nas páginas da loja/arquivo, os produtos variáveis ​​exibem um botão "Selecionar opções" em vez de um botão "Adicionar ao carrinho". Na página individual do produto, o botão "Adicionar ao carrinho" só aparece depois que o cliente seleciona todos os atributos necessários.

Se o botão "Adicionar ao carrinho" estiver completamente ausente da página de um produto variável (e não apenas exibindo as opções de seleção na página da loja), verifique:

• Existe pelo menos uma variação do produto (Dados do produto > Variações > Adicionar variação)

• Pelo menos uma variação está marcada como "Em estoque" com disponibilidade em estoque

• Todos os atributos usados ​​nas variações são definidos em Dados do Produto > Atributos antes da criação das variações

• A aba de variações não mostra nenhum erro de configuração

Um produto variável sem variações criadas, ou com todas as variações fora de estoque, não exibirá o botão "Adicionar ao carrinho".

Status do estoque e configurações de produto fora de estoque

Acesse WooCommerce > Configurações > Produtos > Estoque. Verifique se a opção "Ocultar itens fora de estoque do catálogo" está ativada. Se estiver, qualquer produto marcado como fora de estoque não aparecerá nas páginas da loja e o botão "Adicionar ao carrinho" não será exibido.

Verifique também o status de estoque do produto individual: Produto > Dados do Produto > Inventário > Status do Estoque. Confirme se está definido como Disponível. Um produto definido manualmente como Indisponível não exibirá o botão Adicionar ao Carrinho, independentemente da configuração do catálogo.

Solução 5: Verifique as configurações de páginas e links permanentes do WooCommerce

Uma página de carrinho mal configurada ou uma estrutura de links permanentes desatualizada causam falhas silenciosas que nenhuma depuração de plugins consegue corrigir. Essas três verificações levam menos de 5 minutos e resolvem mais problemas do que a maioria dos donos de lojas imagina.

Verificar atribuição da página do carrinho e da página de finalização da compra

O WooCommerce exige que páginas específicas existam e estejam corretamente atribuídas para que a funcionalidade do carrinho funcione. Se a página do carrinho ou a página de finalização da compra for excluída, despublicada ou reatribuída à página errada, os cliques no botão "Adicionar ao carrinho" falharão silenciosamente ou redirecionarão para a página errada.

Acesse WooCommerce > Configurações > Avançado > Configuração da página. Verifique:

• Carrinho: atribuído a uma página publicada que contém o shortcode [woocommerce_cart] ou o bloco Carrinho do WooCommerce

• Finalização da compra: atribuída a uma página publicada que contém o shortcode [woocommerce_checkout] ou o bloco de finalização da compra do WooCommerce

• Minha Conta: atribuída a uma página publicada que contém o bloco ou código curto "Minha Conta"

Se alguma estiver faltando ou atribuída incorretamente, reatribua-a. Se as próprias páginas estiverem faltando, crie novas páginas com os códigos curtos corretos e atribua-as aqui.

Limpe sua estrutura de links permanentes

O WordPress usa regras de permalink para rotear as requisições corretamente. Se essas regras forem corrompidas, as requisições AJAX do WooCommerce podem falhar mesmo que todas as outras configurações estejam corretas. Limpar a estrutura de permalink regenera essas regras.

Acesse Configurações > Links permanentes no painel do WordPress. Não altere nenhuma configuração. Clique em Salvar alterações. Isso regenera o arquivo .htaccess com novas regras de links permanentes e resolve problemas de roteamento que causam falhas silenciosas no botão do carrinho.

Este procedimento leva menos de 10 segundos e não afeta o seu conteúdo. Vale a pena realizá-lo logo no início de qualquer processo de resolução de problemas, pois não custa nada e corrige um número significativo de falhas no carrinho de compras.

Verifique a página de status do WooCommerce para erros

Acesse WooCommerce > Status. Esta página exibe uma visão geral completa da sua instalação do WooCommerce. As linhas destacadas em vermelho indicam erros de configuração.

Erros comuns exibidos na página de status que afetam o botão "Adicionar ao carrinho":

• Banco de dados desatualizado: as tabelas do banco de dados do WooCommerce precisam ser atualizadas. Clique no botão Atualizar banco de dados.

• WooCommerce.js: o arquivo está ausente ou inacessível. Isso impede diretamente o funcionamento do botão "Adicionar ao carrinho".

• Sobrescritas de modelos: seu tema sobrescreveu arquivos de modelo do WooCommerce. Se as sobrescritas forem de uma versão antiga do WooCommerce, elas podem não conter as funcionalidades mais recentes. Atualize seu tema ou remova as sobrescritas desatualizadas.

Solução 6: Limpe o cache

Um plugin de cache que exibe uma versão desatualizada da página do seu produto pode fazer com que o botão "Adicionar ao carrinho" não responda, mesmo depois de você ter aplicado todas as outras correções. Sempre limpe o cache como uma etapa inicial de solução de problemas e também como uma etapa final após fazer qualquer alteração.

Para limpar o cache no WP Rocket: Clique no ícone do WP Rocket na sua barra de administração > Limpar cache.

Limpar cache no W3 Total Cache: Desempenho > Limpar todos os caches.

Limpe o cache do WP Super Cache: Configurações > WP Super Cache > Excluir cache.

Limpar cache no LiteSpeed ​​Cache: LiteSpeed ​​Cache > Limpar tudo.

Limpar o cache do Cloudflare: Painel do Cloudflare > Cache > Configuração > Limpar tudo.

Limpe o cache do seu navegador: Ctrl+Shift+Delete no Chrome ou Firefox. Limpe as imagens e arquivos em cache. Recarregue a página do produto em uma janela anônima/privada para verificar se a correção foi aplicada, o que garante que o cache do navegador não esteja envolvido.

Após limpar todos os caches, teste o botão "Adicionar ao carrinho" na página do produto afetado. Teste em uma janela anônima para descartar a possibilidade de ser um problema com o cache do navegador.

Lista de verificação para resolução de problemas: a ordem correta

Siga estes passos em ordem. Pare quando o botão funcionar.

• Faça um backup completo do site e do banco de dados

• Identifique o tipo de falha (não aparece / não é clicável / ao clicar, a atualização não é exibida)

• Verifique o console do navegador em busca de erros de JavaScript e anote quaisquer erros específicos

• Acesse Configurações > Links permanentes e clique em Salvar alterações (nenhuma alteração de configuração é necessária)

• Verifique WooCommerce > Status em busca de erros em vermelho e resolva-os

• Verificar dados do produto: preço definido, disponibilidade em estoque, variações configuradas

• Atualize o WordPress, o WooCommerce, todos os plugins e o seu tema

• Limpar todos os caches: plugin de cache + Cloudflare + navegador

• Desative todos os plugins, exceto o WooCommerce, e teste

• Se o botão funcionar com os plugins desativados, reative-os um por um para identificar o conflito

• Mude para o tema Storefront e teste

• Se o botão funcionar com o Storefront, o tema ativo é a causa

• Verifique em WooCommerce > Configurações > Avançado > Configuração da página para atribuição das páginas do carrinho e de finalização da compra

• Adicione os scripts do WooCommerce à lista de exclusões do seu plugin de otimização

Considerações finais sobre a correção do botão "Adicionar ao carrinho" do WooCommerce

A maioria das falhas no botão "Adicionar ao carrinho" do WooCommerce são causadas por conflitos de plugins, problemas de cache ou dados de produto incompletos. Todos os três possuem caminhos de diagnóstico claros e soluções específicas que não exigem desenvolvimento personalizado.

Comece pela tabela de diagnóstico para identificar o tipo de problema. Verifique a página de status e atualize os links permanentes primeiro — isso não custa nada e resolve um número significativo de casos. Atualize tudo antes de fazer qualquer outra alteração. Em seguida, siga o processo de resolução de conflitos entre plugins e temas.

Se você já aplicou todas as correções desta lista e o botão ainda não funciona, o problema provavelmente é um conflito de código personalizado ou um problema de configuração no servidor. Nesse caso, um desenvolvedor WordPress com experiência em WooCommerce deve analisar os erros no console do navegador, o log de erros do servidor e o log de depuração do WooCommerce em conjunto.

A equipe de desenvolvimento WooCommerce da Seahawk resolve problemas com o botão "Adicionar ao carrinho" como parte de seu serviço de suporte emergencial e manutenção contínua.

Perguntas frequentes sobre o botão "Adicionar ao carrinho" do WooCommerce que não funciona