Schema markup em WordPress: guia completo de implementação

Schema markup é código estruturado que ajuda o Google a compreender o conteúdo do site e a apresentá-lo como rich results — avaliações com estrelas, FAQ, receitas, produtos com preço, eventos. Para sites WordPress de clientes, schema bem implementado pode aumentar o CTR orgânico em 20-30% sem alterar posições. Este guia cobre implementação prática, não teoria.

O que é schema markup e por que importa

Schema markup é um vocabulário de dados estruturados (schema.org) que pode ser adicionado ao HTML usando JSON-LD, Microdata ou RDFa. O Google, Bing e outros motores de busca usam estes dados para compreender melhor o conteúdo e mostrar resultados enriquecidos (rich results) nas SERPs.

Exemplos de rich results que o schema ativa:

• Estrelas de avaliação em resultados de produtos e serviços
• FAQ expandida diretamente nos resultados de pesquisa
• Sitelinks search box na homepage
• Breadcrumbs nos resultados
• Artigos com data de publicação e autor
• Produtos com preço e disponibilidade
• Eventos com data, localização e preço

Formato recomendado: JSON-LD

Existem três formatos para schema: JSON-LD, Microdata e RDFa. O Google recomenda JSON-LD por ser mais fácil de implementar e manter — é um bloco de script separado do HTML, não misturado com o conteúdo.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Minha Empresa",
  "url": "https://minhaempresa.pt",
  "logo": "https://minhaempresa.pt/logo.png",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+351-210-000-000",
    "contactType": "customer service",
    "areaServed": "PT",
    "availableLanguage": "Portuguese"
  }
}
</script>

Tipos de schema mais relevantes por tipo de site

Site institucional / empresa

• Organization: informação sobre a empresa — nome, logo, contactos, redes sociais
• LocalBusiness: para negócios físicos — morada, horário, telefone (NAP consistency)
• WebSite: permite sitelinks search box (se o site tiver pesquisa interna)
• BreadcrumbList: breadcrumbs nos resultados de pesquisa

Blog / artigos

• Article / BlogPosting: com headline, datePublished, dateModified, author, image
• FAQPage: secções FAQ que aparecem expandidas nos resultados
• HowTo: artigos de guia passo a passo com steps individuais

WooCommerce / loja

• Product: com name, description, image, price, availability, brand
• AggregateRating: avaliações com estrelas — muito importante para produtos
• Offer: preço e disponibilidade — requerido para produto aparecer em Google Shopping

Como implementar em WordPress: opções

Via plugin SEO (Yoast / RankMath)

Yoast SEO e RankMath geram automaticamente schema básico para artigos, páginas e WooCommerce. É o ponto de partida mais simples. Limitações: schema genérico, não personalizado para necessidades específicas do cliente.

No Yoast: SEO → Search Appearance → configura o tipo de cada página e a organização. No RankMath: Rank Math → Titles & Meta → configura schema por tipo de conteúdo.

Via Schema Pro ou Rank Math Schema

Para schema mais avançado sem código, Schema Pro (pago) e o módulo Schema do RankMath Pro permitem criar schema personalizado por tipo de página com campos configuráveis.

Via código personalizado (para agências)

Para controlo total, implemente schema via wp_head hook em functions.php ou plugin de site:

add_action('wp_head', function() {
    if (is_singular('post')) {
        $schema = [
            '@context' => 'https://schema.org',
            '@type' => 'BlogPosting',
            'headline' => get_the_title(),
            'datePublished' => get_the_date('c'),
            'dateModified' => get_the_modified_date('c'),
            'author' => [
                '@type' => 'Person',
                'name' => get_the_author()
            ],
            'publisher' => [
                '@type' => 'Organization',
                'name' => get_bloginfo('name'),
                'logo' => ['@type' => 'ImageObject', 'url' => get_site_icon_url()]
            ]
        ];
        echo '<script type="application/ld+json">' .
             json_encode($schema, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) .
             '</script>';
    }
});

Validar schema: ferramentas

• Google Rich Results Test: search.google.com/test/rich-results — verifica se o Google consegue ler o schema e se está elegível para rich results
• Schema.org Validator: validator.schema.org — valida a estrutura do schema
• Google Search Console: relatório "Enhancements" → mostra erros de schema em todo o site

Erros comuns a evitar

• Schema de avaliações falsas: o Google penaliza avaliações de primeira pessoa ou não verificadas. Use schema de AggregateRating apenas com avaliações genuínas de terceiros.
• Schema não corresponde ao conteúdo visível: o schema deve descrever o que está na página — não adicione preços em schema que não aparecem visualmente.
• Duplicar schema de plugins: se Yoast e um plugin de schema separado geram ambos schema para o mesmo tipo, pode criar conflito. Use apenas uma fonte.
• Schema de Organization em todas as páginas: Organization deve estar na homepage, não repetido em cada página.