Rank Math schema CPT ACF não gera: como corrigir

Tipo SEO Tecnico

Nome do erro Schema do Rank Math nao gera para Custom Post Type do ACF PRO EN: Rank Math schema not generated for ACF PRO custom post type

Severidade Atenção

Descrição O schema do Rank Math não gera para o Custom Post Type do ACF PRO quando o post type não esta público, não aparece na aba própria de Titles e Meta, ou tem o campo Schema Type definido como nenhum, deixando as páginas do CPT sem JSON-LD.

O que é schema do Rank Math que não gera para CPT do ACF PRO?

O schema do Rank Math para CPT do ACF PRO depende de o plugin enxergar o Custom Post Type registrado e ter uma aba própria em Titles e Meta. Segundo a documentação do Rank Math, cada post type ganha uma seção com o ajuste Schema Type, que define o schema padrão emitido em todas as entradas daquele tipo. Quando você cria um Custom Post Type pelo ACF PRO (em ACF, Post Types) e abre uma entrada, espera que o Rank Math injete o JSON-LD no código fonte como faz em posts e páginas, mas a página do CPT sai sem nenhum bloco de schema.

O problema raiz quase sempre esta na visibilidade do post type ou no ajuste padrão de schema. O Rank Math so cria a aba de configuração para post types publicos com interface visivel, e so emite o schema padrão se o Schema Type daquela aba estiver definido como Article, Product ou outro valor concreto, e não como None. Se o CPT do ACF PRO foi registrado como não público, sem show_ui, ou o módulo Schema esta desativado, o Rank Math não tem onde ancorar o schema e o JSON-LD nunca aparece.

Como identificar

A página de uma entrada do Custom Post Type criado no ACF PRO sai sem nenhum bloco JSON-LD do Rank Math no código fonte (Ctrl+U e busca por application/ld+json não retorna o schema do conteúdo).
Em Rank Math, Titles e Meta não existe uma aba própria para o seu Custom Post Type, apenas Posts, Páginas e outros tipos padrão.
Ao testar a URL do CPT no Rich Results Test do Google ou no Schema Markup Validator, o relatório retorna que nenhum item estruturado foi detectado.
O editor do Rank Math no CPT mostra a aba Schema vazia ou com o aviso de que nenhum schema esta atribuido aquele post type.
Posts e páginas normais geram o schema corretamente, mas somente as entradas do post type registrado pelo ACF PRO ficam sem estrutura.

Antes de começar: Antes de alterar o registro do Custom Post Type ou mexer nos argumentos de visibilidade em código, faça um backup do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, porque mudar public ou rewrite de um post type já indexado pode alterar URLs e afetar o ranking das páginas existentes.

Como prevenir

Registre Custom Post Types que devem ranquear sempre como publicos e com interface visivel, para o Rank Math criar a aba de Titles e Meta e gerar o schema desde o inicio.
Ao criar um novo CPT, já defina o Schema Type adequado na aba de Titles e Meta antes de publicar conteúdo, evitando páginas no ar sem estrutura.
Mantenha o módulo Schema do Rank Math ativo e padronize qual schema cada tipo de conteúdo usa, documentando a escolha para a equipe.
Depois de registrar ou alterar um post type, valide uma entrada no Rich Results Test para confirmar que o JSON-LD esta sendo emitido como esperado.

Causa

O Custom Post Type foi registrado pelo ACF PRO com public definido como falso ou sem show_ui: o Rank Math so cria a aba de configuração em Titles e Meta para post types publicos com interface visivel, entao um CPT oculto nunca recebe o ajuste de Schema Type.
A aba do post type existe em Rank Math, Titles e Meta, mas o campo Schema Type daquele CPT esta definido como None, e por isso o Rank Math não emite nenhum schema padrão para as entradas do tipo.
O módulo Schema do Rank Math esta desativado em Rank Math, Painel, Módulos, entao o plugin nem chega a gerar o JSON-LD para qualquer post type, inclusive o CPT do ACF PRO.
O Custom Post Type foi registrado no hook init com prioridade tardia ou depois do Rank Math montar suas configurações, fazendo o plugin não enxergar o tipo na hora de criar a aba de Titles e Meta.
Uma condicao de exibicao (Display Conditions) de um schema customizado no Schema Generator esta restrita a posts ou páginas e não inclui o slug do CPT do ACF PRO, deixando aquele tipo de fora da regra de schema.

Como resolver

Confirme que o módulo Schema esta ativo: Antes de tudo, garanta que o Rank Math esta autorizado a gerar JSON-LD. Sem o módulo Schema ligado, nenhum post type recebe estrutura, nem o CPT do ACF PRO.
```
Painel WP -> Rank Math SEO -> Painel (Dashboard) -> aba Módulos
Ative o módulo Schema (Structured Data) e salve
```
Torne o Custom Post Type público no ACF PRO: O Rank Math so cria a aba de Titles e Meta para post types publicos com interface visivel. Em ACF, abra o Post Type e ative as opções de visibilidade pública para o plugin passar a enxergar o tipo.
```
Painel WP -> ACF -> Post Types -> abra o seu Custom Post Type
Em Advanced Configuration -> Visibility, defina Public como Sim e Show In UI como Sim
Salve as alterações do Post Type
```
Defina o Schema Type na aba do post type: Com o CPT visivel, o Rank Math passa a exibir uma aba própria em Titles e Meta. Abra essa aba e troque o Schema Type de None para um schema concreto como Article, para o plugin emitir o JSON-LD padrão em todas as entradas.
```
Painel WP -> Rank Math SEO -> Titles e Meta
Selecione a aba do seu Custom Post Type na lista lateral
No campo Schema Type, escolha Article (ou o tipo adequado) em vez de None e salve
```

Limpe o cache e revalide a entrada: Schema fica em cache do site e de CDN. Limpe os caches, abra uma entrada do CPT e confira no código fonte se o bloco application/ld+json do Rank Math agora aparece.

Limpe o cache do plugin de cache e do CDN (ex.: WP Rocket, Cloudflare)
Abra uma entrada do CPT no navegador e use Ctrl+U para ver o código fonte
Procure por application/ld+json e confirme o bloco de schema do Rank Math

Valide o JSON-LD no Rich Results Test: Confirme que o schema gerado e valido aos olhos do Google. Cole a URL da entrada do CPT no Rich Results Test e verifique se o tipo aparece sem erros.

Acesse o Rich Results Test do Google e o Schema Markup Validator
Cole a URL pública de uma entrada do Custom Post Type
Confirme que o schema escolhido e detectado sem erros nem avisos criticos

PHP

<?php
// Garante que o CPT do ACF PRO seja publico e visivel a tempo do Rank Math.
add_action( 'init', 'full_force_cpt_public_para_rank_math', 5 );
function full_force_cpt_public_para_rank_math() {
    global $wp_post_types;
    $post_type = 'projeto'; // troque pelo slug do seu CPT do ACF PRO
    if ( isset( $wp_post_types[ $post_type ] ) ) {
        $wp_post_types[ $post_type ]->public              = true;
        $wp_post_types[ $post_type ]->publicly_queryable   = true;
        $wp_post_types[ $post_type ]->show_ui             = true;
        $wp_post_types[ $post_type ]->show_in_rest        = true;
    }
}

Perguntas frequentes

Por que o Rank Math não gera schema para o meu Custom Post Type do ACF PRO

Na maioria dos casos o post type foi registrado como não público ou sem interface visivel, entao o Rank Math não cria a aba de configuração em Titles e Meta e não tem onde definir o Schema Type. Torne o CPT público no ACF e defina o Schema Type da aba para um valor concreto.

Onde fica o ajuste de schema por post type no Rank Math

Em Rank Math SEO, Titles e Meta, cada post type público ganha uma aba própria com o campo Schema Type, que define o schema padrão emitido em todas as entradas daquele tipo. Para o CPT do ACF PRO, troque esse campo de None para Article ou outro tipo adequado.

Preciso do módulo Schema ativo para o CPT receber JSON-LD

Sim. O Rank Math so emite structured data com o módulo Schema ligado em Rank Math, Painel, Módulos. Com o módulo desativado, nenhum post type recebe JSON-LD, inclusive o Custom Post Type criado pelo ACF PRO.

O Custom Post Type precisa ser público para ter schema

Para o Rank Math gerenciar títulos, meta e schema, o post type precisa ser público e ter interface visivel, pois o plugin so cria a aba de configuração para tipos visiveis. Um CPT oculto pode existir, mas não recebera a aba de Schema Type.

Como faço o schema do CPT usar valores de campos do ACF

O Schema Type padrão da aba cobre o schema base. Para mapear valores de campos ACF em propriedades do schema, use o Schema Generator do Rank Math no editor da entrada e preencha as propriedades com variaveis ou os valores dos campos personalizados.

Alterar o post type para público muda as URLs das entradas

Pode mudar, porque visibilidade e rewrite influenciam o permalink do post type. Se as entradas já estão indexadas, teste em staging e configure redirecionamentos se a URL mudar, para não perder o ranking já conquistado.

Por que so o CPT fica sem schema e posts e páginas funcionam

Posts e páginas já vem com aba e Schema Type configurados por padrão no Rank Math. O Custom Post Type do ACF PRO so passa a ter essa aba quando e público, e o Schema Type comeca como None até você definir, por isso so ele fica sem estrutura.

Registrar o CPT em código em vez de pelo ACF resolve o schema

O que importa e o post type ser registrado como público e com show_ui antes do Rank Math montar suas configurações, independente de vir do ACF ou de código. Registre no hook init e garanta as flags de visibilidade para o Rank Math criar a aba de schema.

Atenção

Como corrigir o 404 Monitor do Rank Math que não registra erros no WordPress

O Rank Math 404 Monitor não funciona quando o módulo está desativado, o Log Limit está em 0, um cache/CDN entrega os 404 sem chegar ao PHP do WordPress, ou regras de Exclude Paths descartam os erros antes de gravar.

Grave

Como corrigir robots.txt bloqueando páginas importantes no WordPress

Um robots txt no WordPress bloqueando páginas importantes acontece quando uma regra Disallow ampla impede o Google de rastrear seções do site, derrubando o tráfego orgânico. A causa mais comum é a opção 'Desencorajar mecanismos de busca' nas Configurações de Leitura ou uma regra herdada de plugin que barra pastas indevidas.

Grave

Como corrigir meta tags duplicadas entre SEOPress e Rank Math

Meta tags duplicadas entre SEOPress e Rank Math aparecem quando os dois plugins de SEO ficam ativos ao mesmo tempo e cada um injeta a própria title tag, meta description e Open Graph no head da página. A correção e manter apenas um plugin gerando metadados.

Atenção

Como corrigir o Vídeo Schema no Rank Math PRO

O erro do Vídeo Schema no Rank Math PRO ocorre quando o Vídeo Rich Snippet e gerado sem os campos obrigatorios pelo Google, como thumbnailUrl, contentUrl ou embedUrl e uploadDate, fazendo o Teste de Resultados Aprimorados reprovar a marcacao do vídeo.

Atenção

Como corrigir Breadcrumbs duplicados entre Astra Pro e Rank Math

Breadcrumbs duplicados entre Astra Pro e Rank Math aparecem quando o tema Astra renderiza a própria trilha de navegação e o Rank Math também emite a dele na mesma página. A correção e definir uma única fonte de breadcrumb, mantendo so o tema ou so o plugin renderizando a trilha.

Atenção

Como corrigir o Local SEO do SEOPress que não funciona no WordPress

O Local SEO do SEOPress não funciona quando o módulo Local Business está sem licença PRO ativa, com campos obrigatórios em branco ou com o schema LocalBusiness bloqueado por cache, conflito de plugin ou dado incompleto, fazendo o negócio local não aparecer para o Google.

Setores

Extensões

Integrações

Como corrigir o schema do Rank Math que não gera para Custom Post Types do ACF PRO no WordPress

O que é schema do Rank Math que não gera para CPT do ACF PRO?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o 404 Monitor do Rank Math que não registra erros no WordPress

Como corrigir robots.txt bloqueando páginas importantes no WordPress

Como corrigir meta tags duplicadas entre SEOPress e Rank Math

Como corrigir o Vídeo Schema no Rank Math PRO

Como corrigir Breadcrumbs duplicados entre Astra Pro e Rank Math

Como corrigir o Local SEO do SEOPress que não funciona no WordPress

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