Adicionar campos personalizados em produtos WooCommerce com ACF é a técnica de estender a ficha do produto com informações que a loja padrão não oferece, como prazo de fabricação, ficha técnica ou um selo de garantia, usando o Advanced Custom Fields. O WooCommerce traz preço, estoque e atributos, mas cada nicho precisa de dados próprios, e o ACF resolve isso sem você editar o core. Este guia faz parte do hub de ACF PRO da FULL e mostra o passo a passo real, do grupo de campos à exibição na página do produto.

O que são campos personalizados em produtos e quando usar

Campos personalizados em produtos são informações extras que você anexa à ficha do produto além de preço, estoque e atributos, como material, voltagem ou prazo de produção, guardadas em meta do post e gerenciadas pelo ACF com uma interface amigável no editor. Eles existem para cobrir o dado específico do seu nicho, que o WooCommerce não prevê. A diferença para um atributo é o propósito: atributo filtra e varia, campo descreve.

Na prática, você cria um grupo de campos no ACF, escolhe o tipo de cada um e o anexa ao post type de produto, ganhando campos limpos no editor em vez de digitar meta na unha. Assim, uma loja de eletrônicos exibe voltagem e garantia, e uma de móveis mostra dimensões. Nos atendimentos da FULL sobre ACF PRO, a dúvida mais comum é confundir campo personalizado com atributo de variação, quando cada um resolve um problema diferente.

Legenda: o ACF adiciona campos limpos na ficha do produto, sem editar o core do WooCommerce.

Quando vale usar ACF em vez dos atributos do WooCommerce

Vale usar campos ACF quando o dado descreve o produto mas não precisa filtrar nem gerar variação de preço, como uma ficha técnica, um aviso de garantia ou um campo de origem, e vale ficar nos atributos do WooCommerce quando a informação cria opções de compra, como tamanho ou cor que mudam o estoque e o preço. A regra é o papel do dado: descrever pede ACF, escolher pede atributo.

Use este teste antes de decidir. Diga SIM ao ACF se o dado é uma informação fixa do produto que você só quer mostrar, sem o cliente selecionar. Diga NÃO, e use atributo, se o dado vira uma variação que o cliente escolhe no carrinho. O encaixe ideal do ACF é a ficha rica que diferencia o seu produto, sem inflar o sistema de variações. Para organizar a vitrine que exibe esses dados, o material de tabela de produtos no WooCommerce ajuda no layout.

Pré-requisitos antes de criar os campos

Antes de criar os campos personalizados você precisa de três peças no lugar, o WooCommerce com produtos cadastrados, o ACF instalado e ativo e uma definição de quais dados extras o seu produto precisa, e a falta de qualquer uma deixa o grupo de campos sem uso ou mal estruturado. Sem saber o dado que falta, você cria campos que ninguém preenche.

Checklist de prontidão antes de começar:

• WooCommerce instalado, com ao menos um produto cadastrado para teste.
• ACF instalado e ativo, na versão gratuita ou PRO.
• A lista dos dados extras que o produto precisa exibir.
• Os tipos de campo definidos: texto, número, seleção ou imagem.
• Acesso ao template do produto ou a um construtor para exibir o campo.
• Um produto de teste preenchido para validar a exibição.
• Permissão de administrador para criar grupos de campos.

Pense no conjunto como uma etiqueta extra na embalagem: o produto é a caixa, o grupo de campos é o modelo da etiqueta e cada field é uma linha de informação. Uma etiqueta criada mas nunca colada na caixa não ajuda o cliente.

Como adicionar campos personalizados em 5 passos

Adicionar campos personalizados segue cinco passos, do grupo de campos à exibição no frontend, e respeitar a ordem evita o erro mais comum: criar o campo, preencher e esquecer de mostrá-lo na página. Cada passo isola uma etapa, do ACF ao template. Confirme antes que o produto de teste existe, porque é nele que você valida a exibição.

Passo 1: Crie o grupo de campos no ACF

Abra o ACF e crie um grupo de campos com as informações extras do produto, dando a cada field um nome claro e escolhendo o tipo certo, porque é esse nome que você vai usar para exibir o dado depois. Use texto para uma ficha, número para uma medida, seleção para um conjunto fixo de opções e imagem para um selo. Anote o nome de cada field. Um grupo bem nomeado é a base de toda a exibição, e renomear um field depois quebra a referência que o mostra na página.

Passo 2: Atribua o grupo ao produto

Na seção de regras de localização do grupo de campos, defina que ele aparece quando o tipo de post é igual a Produto, porque é essa regra que faz os campos surgirem no editor do WooCommerce, e não em posts comuns. O ACF permite condições mais finas, como uma categoria de produto específica, se você só quer os campos em parte do catálogo. Salve o grupo. Sem essa regra, os campos existem mas nunca aparecem na ficha do produto, e o lojista não tem onde digitar o dado.

Passo 3: Preencha os campos no produto

Abra um produto e preencha os campos personalizados que agora aparecem no editor, inserindo o dado real de cada item, porque o template só terá o que mostrar se o valor existir. Comece por um produto de teste para validar o fluxo antes de aplicar ao catálogo inteiro. Se você gerencia muitos itens, planeje como vai preencher em massa, talvez por importação. Um campo em branco no produto gera um espaço vazio na página, então defina um valor padrão quando fizer sentido para o tipo de campo.

Passo 4: Exiba o campo no frontend

Mostre o valor do campo na página do produto, seja editando o template, usando um hook do WooCommerce ou um construtor que leia campos ACF, porque é esse passo que tira o dado do admin e o entrega ao cliente. O ACF oferece funções para recuperar e imprimir o valor pelo nome do field. Se o campo não aparece mesmo preenchido, veja como corrigir os Custom Fields que não aparecem no frontend no ACF PRO, porque um valor preso no admin não serve de nada ao comprador.

Passo 5: Valide a exibição no produto

Abra a página do produto de teste no frontend e confirme que o campo aparece no lugar certo, com o valor correto e a formatação esperada, porque só a visão do cliente prova que o fluxo funcionou de ponta a ponta. Cheque em um produto preenchido e em outro vazio para ver como o template lida com a ausência de valor. Ajuste a posição do campo no template se necessário. Teste mais de um produto, porque um campo opcional vazio só aparece em alguns itens e passa despercebido no resto.

Legenda: cada passo liga uma etapa, do grupo de campos ao dado visível para o cliente.

Erros comuns ao usar ACF em produtos

Os três erros mais comuns ao usar campos ACF em produtos são salvar o dado e não exibi-lo no frontend, errar o nome do field na hora de imprimir e sobrecarregar o produto com campos demais. O primeiro é o mais frequente: o lojista preenche tudo no editor, mas o template nunca foi ajustado para mostrar o campo, e o dado fica invisível para o cliente, preso no admin.

O segundo erro é a referência errada: a função que imprime o valor usa um nome de field que não bate com o do ACF, em geral por uma diferença de maiúscula, e a página não mostra nada. A correção é copiar o nome exato do field. O terceiro caso é o excesso: dezenas de campos em cada produto pesam o editor e o banco, e quando isso derruba a performance, vale ver como corrigir a lentidão do ACF PRO com muitos Custom Fields. Crie só os campos que o cliente realmente vê.

Como manter os campos em produção

Manter os campos personalizados em produção exige cuidar de duas frentes, a consistência do preenchimento a cada novo produto e o impacto dos campos dinâmicos no cache, porque um campo vazio quebra o layout e um valor cacheado errado mostra dado antigo. A rotina de cadastro precisa incluir o preenchimento dos campos, senão a ficha nasce furada.

Padronize o cadastro para que todo produto novo receba os campos obrigatórios, e use valores padrão onde o template precisa sempre de algo. Quando os campos alimentam blocos dinâmicos e o cache serve uma versão antiga, o caminho é conferir como corrigir o cache de campos dinâmicos do ACF com o WP Rocket. Para escalar a edição em catálogos grandes, vale também o material de tabela de produtos no WooCommerce, que ajuda a visualizar os dados de muitos itens.

Como a FULL faz isso em escala

A FULL padroniza o uso do ACF em produtos porque acompanha mais de 150 mil sites WordPress, e lojas com ficha técnica rica aparecem muito entre lojistas de nicho, onde recriar os mesmos grupos de campos em cada loja vira gargalo. Em vez de licença avulsa por instalação, o ACF PRO entra no bundle e o padrão de campos personalizados fica replicável entre lojas.

No plano PRO da FULL, por R$849, o ACF PRO já vem no pacote para até dez sites, o que dá R$85 por site em vez de pagar cada licença separada. Para quem mantém várias lojas, a gente vê isso trocar um custo recorrente espalhado por um padrão único: o mesmo grupo de campos é exportado e reaproveitado de uma loja para outra, sem recriar a estrutura do zero a cada projeto. É a economia que só aparece quando o stack é o mesmo em toda a base.

Checklist final dos campos personalizados

O checklist final dos campos personalizados confirma, em uma passada, que o dado chega ao cliente antes de você dar o trabalho por concluído. Rode esta lista depois do passo 5 e a cada novo grupo de campos criado, porque é fácil esquecer de exibir um campo recém-adicionado no template.

Antes de declarar pronto, confirme:

• O grupo de campos está atribuído ao post type de produto.
• Cada field tem nome claro e o tipo certo para o dado.
• Os campos obrigatórios estão preenchidos nos produtos.
• O valor aparece no frontend, no lugar e formato esperados.
• O template lida bem com campo vazio, sem quebrar o layout.
• O número de campos por produto é enxuto, sem pesar a edição.
• O cache mostra o valor atual dos campos dinâmicos.

Se qualquer item falhar, volte ao passo correspondente antes de aplicar os campos ao catálogo inteiro.

Perguntas frequentes sobre campos personalizados em produtos WooCommerce com ACF

Próximos passos para enriquecer sua ficha de produto

Adicionar campos personalizados em produtos WooCommerce com ACF é, no fundo, estender a ficha do produto com o dado do seu nicho e garantir que ele chegue ao cliente: crie o grupo, atribua ao produto, preencha, exiba no frontend e valide. O campo salvo mas nunca exibido é o erro que mais desperdiça o trabalho, então teste a página antes de concluir. Para padronizar o ACF PRO em várias lojas sem licença avulsa, conheça os planos da FULL, e para continuar aprendendo, o FULL Academy reúne os tutoriais de WordPress em um só lugar.