O WooCommerce atende bem produtos personalizados quando o projeto separa, antes de qualquer orçamento, três coisas que o lojista costuma chamar pelo mesmo nome de “opção”: a variação que tem estoque, o campo que o cliente preenche e o adicional que muda o preço. Cada uma é resolvida de um jeito diferente, tem limites próprios e chega ao pedido e ao ERP de forma diferente. Este guia é para quem vende canecas, camisetas, brindes, convites, placas ou qualquer produto feito sob pedido e quer chegar à proposta com a regra escrita. Ele parte de uma regra concreta de produto e não pressupõe que tudo seja nativo da plataforma.
Variação, campo ou adicional de preço: qual é a diferença?
A pergunta que separa os três é simples: isto muda o estoque, muda o que o cliente informa ou muda o preço?
| Tipo de opção | Exemplo | Tem estoque e SKU? | Como se resolve no WooCommerce | Limite que afeta o projeto |
|---|---|---|---|---|
| Variação | Cor da caneca, tamanho da camiseta | Sim, por variação | Nativo: produto variável com atributos | Acima de 30 variações, os seletores deixam de ser dinâmicos por padrão |
| Campo de personalização | Nome a gravar, frase, logo enviado | Não | Extensão, como a Product Add-Ons, ou código específico | Não tem SKU nem estoque próprio |
| Adicional de preço | Embalagem para presente, gravação extra, prazo expresso | Não | Extensão ou código específico | Na Product Add-Ons, vale para todas as variações do produto |
Variação. Pela documentação de produtos variáveis, consultada em 20/10/2026, cada variação pode ter preço, estoque, SKU, imagem e peso próprios, e uma variação sem preço não aparece na loja. Use variação quando a escolha corresponde a um item físico diferente na prateleira. A mesma documentação registra um limite prático: com até 30 variações, os seletores da página se ajustam conforme o cliente escolhe; acima disso, ficam estáticos e o cliente pode chegar a uma combinação inexistente, a menos que um desenvolvedor altere esse limite. Transformar personalização em variação multiplica combinações rápido: cinco cores, quatro tamanhos e três acabamentos já são 60.
Campo de personalização. É o que o cliente digita ou envia e que só existe naquele pedido. A documentação do núcleo descreve tipos de produto, atributos e variações; campos preenchidos pelo cliente na página do produto aparecem na extensão Product Add-Ons, paga, ou em soluções de terceiros e código próprio. A Product Add-Ons oferece, entre outros, texto curto (que pode aceitar só letras, só números ou e-mail, com limite de caracteres), texto longo, envio de arquivo, seletor de data e preço definido pelo cliente, e cada campo pode ser obrigatório.
Adicional de preço. Na Product Add-Ons, o adicional pode ser fixo (cobrado uma vez, independentemente da quantidade), por quantidade (multiplicado pela quantidade do produto) ou percentual (sobre o preço do produto). Valores negativos viram desconto. Essa distinção muda o total do pedido e precisa estar escrita na regra: “embalagem para presente” costuma ser uma vez por item; “gravação no verso” costuma ser por unidade.
O que mapear além das opções da página?
A página do produto é a parte visível. O projeto também precisa responder ao que acontece depois do clique em comprar, e aqui nenhuma resposta deve ser assumida como nativa.
- Validações. Quantos caracteres cabem na gravação? Aceita acento e emoji? Que formatos e tamanhos de arquivo são aceitos? A Product Add-Ons permite restringir tipo de caractere e limite de texto; regras como “só aceitar arquivo vetorial” ou “exigir arte quando a gravação for frente e verso” precisam ser verificadas na extensão escolhida. A documentação informa que a extensão não tem lógica condicional própria e sugere combiná-la com outras ferramentas.
- Arquivos do cliente. Pela documentação, os arquivos enviados aparecem no pedido e nos e-mails de confirmação e ficam em pastas com nome aleatório dentro de
wp-content/uploads/. A mesma página alerta que algumas hospedagens permitem listar diretórios e recomenda pedir que isso seja desativado. Defina também por quanto tempo os arquivos ficam guardados e quem os apaga. - Prazo de produção. Produto personalizado raramente sai no mesmo dia. O prazo de produção precisa somar ao prazo de frete mostrado ao cliente, e essa soma depende de como o plugin de frete e o tema exibem a informação.
- Envio ao ERP. Os adicionais da Product Add-Ons não têm SKU próprio e não são tratados como produtos individuais. O ERP recebe o SKU da variação; o texto da gravação, o arquivo e os adicionais chegam, quando chegam, como informação extra do item. Confirme com o fornecedor do conector se esses dados são levados e em que campo, e se o adicional de preço precisa virar um item de serviço para a nota fiscal.
- Variações e adicionais juntos. Em produto variável, os adicionais são herdados por todas as variações; a extensão não permite um conjunto diferente para cada uma. Se só a caneca branca aceita impressão colorida, essa regra não cabe na configuração padrão.
Demonstração: um produto com opções, preço e pedido resultante
O exemplo abaixo é uma demonstração com produto, preços e cliente fictícios. Ele mostra como escrever a regra; o comportamento exato da tela deve ser conferido em homologação com a extensão escolhida.
Produto: Caneca personalizada (produto variável).
| Elemento | Tipo | Configuração na demonstração |
|---|---|---|
| Cor: branca, preta | Variação | SKU CAN-BRANCA e CAN-PRETA, estoque por cor, R$ 45,00 cada |
| Nome para gravar | Campo de texto curto | Obrigatório, somente letras, até 20 caracteres |
| Arte do cliente | Envio de arquivo | Opcional |
| Gravação no verso | Adicional por quantidade | + R$ 6,00 por unidade |
| Embalagem para presente | Adicional fixo | + R$ 10,00 por item do pedido |
Compra simulada: 3 canecas pretas, nome “Ana”, arte enviada, com gravação no verso e embalagem para presente.
PEDIDO DE DEMONSTRAÇÃO
Caneca personalizada - Preta SKU CAN-PRETA x 3
Nome para gravar: Ana
Arte do cliente: arte-ana.png
Gravação no verso (+ R$ 6,00 por unidade)
Embalagem para presente (+ R$ 10,00)
Cálculo esperado
3 x R$ 45,00 (variação) ............. R$ 135,00
3 x R$ 6,00 (adicional por unidade) .. R$ 18,00
1 x R$ 10,00 (adicional fixo) ........ R$ 10,00
Total do item ........................ R$ 163,00
Estoque: baixa 3 unidades de CAN-PRETA
ERP: recebe CAN-PRETA x 3; dados da gravação e arquivo a confirmar no conector
Produção: precisa do nome, da arte e da corDois detalhes desta demonstração costumam passar despercebidos. Pela documentação, por padrão só os adicionais fixos aparecem com o valor ao lado do nome no carrinho e no checkout; os demais exigem ajuste para exibir o preço. E o estoque baixa só da variação: se a embalagem para presente tem estoque limitado, ela precisa de outra solução.
Quais casos de teste fecham a regra?
Escreva cada caso com entrada e resultado esperado, e repita a lista depois de cada atualização do WooCommerce ou da extensão.
| Caso | Entrada | Resultado esperado |
|---|---|---|
| 1 | Comprar sem preencher o nome | Produto não vai para o carrinho; mensagem clara |
| 2 | Nome com número ou acima do limite | Campo recusa a entrada |
| 3 | 1 unidade com embalagem | Adicional fixo cobrado uma vez |
| 4 | 3 unidades com embalagem e verso | Fixo uma vez; verso multiplicado por 3 (cálculo da demonstração) |
| 5 | Arquivo enviado | Arquivo visível no pedido e nos e-mails ao lojista e ao cliente |
| 6 | Variação sem estoque | Cor indisponível não pode ser comprada |
| 7 | Pedido aprovado | ERP recebe SKU e quantidade; dados de personalização no campo combinado |
| 8 | Pedido cancelado | Estoque da variação volta; arquivo tratado conforme a política definida |
| 9 | Compra no celular | Campos, envio de arquivo e preço visíveis e utilizáveis |
Extensão pronta, adaptação ou código específico?
| Caminho | Quando atende | O que entra no orçamento | Risco principal |
|---|---|---|---|
| Extensão pronta | As opções cabem nos campos e nos tipos de preço da extensão, sem regra condicional | Licença anual, configuração, casos de teste | Depender do ciclo de atualização do desenvolvedor |
| Adaptação | A extensão resolve quase tudo, mas falta exibir o preço, ajustar o layout ou levar um dado ao ERP | Licença, horas de ajuste, teste a cada atualização | Ajuste quebrar numa atualização da extensão |
| Código específico | Há regra condicional, preço por fórmula, prévia visual da arte ou fluxo de aprovação | Desenvolvimento, documentação e manutenção do código | Custo contínuo de manter o que foi construído |
A Product Add-Ons é vendida com licença anual no Marketplace; o valor e a forma de renovação estão na página do produto, e entram na conta descrita no guia sobre o custo total de uma loja WooCommerce. Quando a regra exige código específico em boa parte do catálogo, vale reavaliar a escolha entre plataforma pronta ou sob medida, e, se for o caso, o desenvolvimento de e-commerce sob medida. Brindes corporativos com pedido mínimo e preço por cliente somam outra camada de regras, tratada nos requisitos de um e-commerce B2B.
Condições e limites
O comportamento descrito da Product Add-Ons segue a documentação consultada em 20/10/2026 e pode mudar entre versões. Outras extensões de campos personalizados têm regras diferentes e precisam ser avaliadas uma a uma. A documentação informa que personalizações da extensão ficam fora da política de suporte da WooCommerce e que configurações do servidor, como max_input_vars, podem impedir salvar produtos com muitos campos. A integração com ERP depende do conector e não foi testada para este texto.
Próximo passo
Se você ainda compara plataformas para esse tipo de catálogo, veja como comparar WooCommerce e Nuvemshop com a mesma regra de produto. Com a regra escrita, a demonstração e os casos de teste preenchidos para o seu produto, a proposta fica objetiva: conheça a nossa criação de loja com WooCommerce.
