Schema para custom fields com SEOPress e ACF é a técnica de alimentar o dado estruturado de uma página com os valores que você guardou em campos personalizados, em vez de digitar cada propriedade à mão. Quando um post type usa ACF para armazenar informações como autor, nota ou preço, o SEOPress consegue puxar esses valores para o schema por meio de variáveis dinâmicas. O resultado é um schema que se atualiza sozinho a cada post, sem retrabalho. Este guia faz parte do hub de SEO WordPress da FULL e mostra o passo a passo real, do grupo de campos à validação no Rich Results Test.

O que é Schema dinâmico a partir de custom fields

Schema dinâmico a partir de custom fields é o dado estruturado cujas propriedades são preenchidas automaticamente pelos valores de campos personalizados, em vez de texto fixo, de modo que cada post gere o seu próprio schema sem edição manual. Com o ACF guardando os dados e o SEOPress lendo esses campos por variáveis, o JSON-LD reflete o conteúdo real de cada página. A diferença para o schema estático é a manutenção: um se atualiza sozinho, o outro envelhece.

Na prática, você cria um grupo de campos no ACF, preenche os valores em cada post e aponta, no schema do SEOPress, qual field alimenta cada propriedade. Assim, um diretório de profissionais ou um catálogo ganha schema correto em escala. Nos atendimentos da FULL sobre dado estruturado, o erro mais comum é mapear uma propriedade para um field vazio, o que gera um schema inválido que o validador de schema reprova na hora.

Legenda: cada custom field do ACF alimenta uma propriedade do schema via variável dinâmica.

Quando vale puxar o Schema de custom fields

Vale puxar o schema de custom fields quando você tem um post type com dados estruturados repetidos, como um diretório, um catálogo de produtos ou uma base de avaliações, e quer que cada item gere schema sem digitação manual, e não quando o site tem poucas páginas e o schema padrão já resolve. A técnica rende em volume, onde mapear uma vez economiza horas de marcação repetida. Para um punhado de posts, o ganho não compensa o setup.

Use este teste antes de montar o mapeamento. Diga SIM ao schema dinâmico se você tem dezenas ou centenas de itens com a mesma estrutura de dados em ACF. Diga NÃO se são páginas únicas, sem padrão de campo, em que o schema manual do SEOPress já dá conta. O encaixe ideal é o post type com campos consistentes, em que cada novo item se beneficia do mapeamento criado uma vez. Para a base de dado estruturado, o material de rich snippets no Google mostra o resultado que o schema busca.

Pré-requisitos antes de mapear

Antes de mapear o schema você precisa de três peças no lugar, o ACF com um grupo de campos criado e exibindo dados, o SEOPress com o módulo de schema ativo e a decisão de qual tipo de schema combina com o post type, e a falta de qualquer uma gera propriedade vazia ou tipo errado. Se o field não mostra valor no frontend, o schema também não terá o que ler.

Checklist de prontidão antes de começar:

• ACF instalado, com o grupo de campos criado e atribuído ao post type.
• Os campos preenchidos em ao menos um post, com valor visível no frontend.
• SEOPress ativo, com o módulo de schema (Dados Estruturados) habilitado.
• A decisão do tipo de schema, como Product, LocalBusiness ou Review.
• Os nomes exatos dos custom fields, para usar nas variáveis dinâmicas.
• Acesso ao Rich Results Test para validar o resultado.
• Permissão de administrador para editar campos e schema.

Pense no conjunto como uma planilha que vira etiqueta: o ACF é a planilha com os dados, o tipo de schema é o modelo da etiqueta e a variável dinâmica é a fórmula que puxa cada célula para o lugar certo. Uma célula vazia gera uma etiqueta furada.

Como configurar o Schema de custom fields em 5 passos

Configurar o schema de custom fields segue cinco passos, do grupo de campos à validação no Google, e respeitar a ordem evita o erro mais comum: mapear uma propriedade antes de o field existir e exibir valor. Cada passo isola uma etapa, do ACF ao teste. Confirme antes que os campos aparecem no frontend, porque é de lá que o schema lê o dado.

Passo 1: Crie o grupo de campos no ACF

Abra o ACF e crie um grupo de campos com as informações que vão alimentar o schema, atribuindo o grupo ao post type certo e definindo o nome de cada field com cuidado, porque é esse nome que você vai usar na variável dinâmica depois. Escolha tipos de campo coerentes com o dado: número para preço, texto para nome, seleção para categoria. Anote os nomes exatos dos fields. Um grupo bem estruturado no ACF é a base de todo o mapeamento, e mudar o nome de um field depois quebra a variável que aponta para ele.

Passo 2: Exiba os campos no frontend

Garanta que os valores dos custom fields aparecem na página, seja pelo template do tema, pelo construtor ou por um bloco, porque o schema lê o dado do post, e um field invisível costuma indicar valor ausente. Preencha os campos em ao menos um post de teste e confirme que eles renderizam. Se os custom fields não aparecem no frontend, veja como corrigir os Custom Fields que não aparecem no frontend no ACF PRO antes de seguir, porque mapear um field vazio só gera schema inválido.

Passo 3: Crie o Schema no SEOPress

No SEOPress, abra as configurações de dados estruturados do post type e crie o schema do tipo que combina com o conteúdo, como Product para um catálogo ou LocalBusiness para um diretório, porque o tipo define quais propriedades você poderá mapear. Consulte o vocabulário em Schema.org para confirmar as propriedades obrigatórias do tipo escolhido. Crie o schema no nível do post type, não post a post, para o mapeamento valer para todos os itens. Esse é o molde que as variáveis vão preencher.

Passo 4: Mapeie as variáveis dinâmicas

Em cada propriedade do schema, troque o texto fixo pela variável dinâmica que aponta para o custom field correspondente, usando a sintaxe de campo do SEOPress com o nome exato do field do ACF, porque é esse mapeamento que torna o schema automático. Ligue name ao field de nome, price ao field de preço, e assim por diante. Confira a grafia do nome do field, já que um erro de digitação deixa a propriedade vazia. Mapeie só as propriedades cujo field sempre tem valor, para não gerar schema inválido em alguns posts.

Passo 5: Valide no rich results test

Cole a URL de um post preenchido no Rich Results Test e confirme que o schema aparece com as propriedades puxando os valores dos custom fields, sem nenhum campo obrigatório vazio, porque é o teste que prova que o mapeamento funcionou. A ferramenta mostra o JSON-LD montado e marca em vermelho a propriedade obrigatória ausente. Teste mais de um post, porque um field vazio só aparece em alguns. Se a marcação sai quebrada mesmo com os campos preenchidos, veja como corrigir o schema markup quebrado no WordPress.

Legenda: cada passo liga uma etapa, do grupo de campos ACF ao schema validado.

Erros comuns ao mapear Schema de custom fields

Os três erros mais comuns no schema de custom fields com SEOPress e ACF são mapear um field que não tem valor, errar o nome do field na variável e usar um tipo de campo incompatível com a propriedade. O primeiro é o mais frequente: a propriedade aponta para um field vazio em parte dos posts, e o Rich Results Test reprova só naqueles itens, o que passa despercebido se você testa um post só.

O segundo erro é a grafia: a variável usa um nome de field que não bate com o do ACF, em geral por uma troca de maiúscula ou um caractere a mais, e a propriedade fica em branco. A correção é copiar o nome exato do field. O terceiro caso é o tipo incompatível, como mapear um campo de texto para uma propriedade que espera número, o que invalida o JSON-LD. Quando um field do tipo repetidor não guarda os dados, o schema também falha, e o caminho é ver como corrigir o Repeater Field que não salva dados no ACF PRO.

Como acompanhar o Schema em produção

Acompanhar o schema dinâmico em produção exige cruzar o relatório de aprimoramentos do Search Console com uma checagem dos custom fields, porque o primeiro mostra quantos itens têm schema válido e o segundo confirma que os fields seguem preenchidos a cada novo post. Um schema que era válido pode esvaziar quando alguém cria um item sem preencher um campo.

No relatório de aprimoramentos, acompanhe o tipo de schema correspondente e investigue qualquer crescimento de itens com erro, porque costuma sinalizar um post novo com field em branco ou um nome de field renomeado. Em sites que combinam ACF com outro gerenciador de campos, um conflito pode esvaziar os valores, e vale ver como corrigir o conflito de Custom Fields entre ACF PRO e JetEngine. Para aprofundar a estratégia de dado estruturado, o material de rich snippets no Google conecta o schema ao resultado.

Como a FULL faz isso em escala

A FULL padroniza esse mapeamento de schema porque acompanha mais de 150 mil sites WordPress, e diretórios, catálogos e bases com ACF aparecem muito entre agências e construtores, onde refazer o schema de cada post type em cada site vira gargalo. Em vez de licença avulsa por instalação, o ACF PRO, que sustenta os custom fields, entra no bundle e o padrão de schema dinâmico fica replicável entre projetos.

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ários sites com dados estruturados, a gente vê isso trocar um custo recorrente espalhado por um padrão único: o mesmo grupo de campos e o mesmo mapeamento de schema são reaproveitados de um site para outro, sem refazer do zero a cada projeto. É a economia que só aparece quando o stack é o mesmo em toda a base.

Checklist final do Schema de custom fields

O checklist final do schema de custom fields confirma, em uma passada, que o mapeamento gera dado estruturado válido antes de você dar o trabalho por concluído. Rode esta lista depois do passo 5 e a cada novo post type que receber schema dinâmico, porque é na criação de um item incompleto que a marcação costuma esvaziar.

Antes de declarar pronto, confirme:

• O grupo de campos do ACF está atribuído ao post type certo.
• Os custom fields aparecem com valor no frontend.
• O tipo de schema do SEOPress combina com o conteúdo do post type.
• Cada propriedade mapeia o nome exato do field correspondente.
• Só os fields sempre preenchidos alimentam propriedades obrigatórias.
• O Rich Results Test passou em mais de um post, sem campo vazio.
• O relatório de aprimoramentos do Search Console está sendo acompanhado.

Se qualquer item falhar, volte ao passo correspondente antes de aplicar o schema a mais posts.

Perguntas frequentes sobre Schema para custom fields com SEOPress e ACF

Próximos passos para escalar seu dado estruturado

Configurar schema para custom fields com SEOPress e ACF é, no fundo, deixar cada post gerar o próprio dado estruturado: crie o grupo de campos, exiba os valores, escolha o tipo de schema, mapeie as variáveis e valide no Rich Results Test. A propriedade ligada a um field vazio é o que mais reprova schema dinâmico, então teste mais de um post antes de concluir. Para padronizar o ACF PRO em vários sites 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.