Campo hasMerchantReturnPolicy não encontrado: a correção

Q: E se a minha loja não aceita devolução?

Diga isso na marcação: use https://schema.org/MerchantReturnNotPermitted em returnPolicyCategory, com o seu applicableCountry. No Search Console, escolha sem devolução no prazo.

A marcação dos seus produtos não traz a política de devolução. Os produtos continuam podendo aparecer como informação do comerciante. Colocar a política deixa o Google mostrar, ao lado deles, o prazo e o custo de devolução.

O caminho rápido: Search Console

Abra Configurações > Shopping > Entregas e devoluções e depois a guia Devolução.
Clique em Adicionar política de devolução e escolha o país.
Coloque o URL da página da sua política de devolução, o prazo de devolução em dias (ou sem devolução) e o custo: grátis, taxa fixa ou uma porcentagem do preço.
Repita para cada país para onde você envia.

O Google confere as políticas de devolução à mão. Isso leva de 10 a 13 dias, e a política fica pendente até lá. O Google dá a essas configurações mais peso que à marcação das páginas. A documentação não diz se elas tiram este aviso do relatório.

O caminho pela marcação

Para uma política única na loja, o Google recomenda hasMerchantReturnPolicy dentro de Organization, numa página só, como a página de trocas e devoluções. Use na oferta só para produtos com regras próprias, ou se você não tem uma política geral. A política do produto vale mais que a geral. No exemplo, 30 dias para devolver pelo correio, grátis, no Brasil:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Bolsa de Viagem de Lona",
  "image": "https://exemplo.com.br/fotos/bolsa-de-viagem.jpg",
  "offers": {
    "@type": "Offer",
    "price": 389.9,
    "priceCurrency": "BRL",
    "availability": "https://schema.org/InStock",
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "applicableCountry": "BR",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": 30,
      "returnMethod": "https://schema.org/ReturnByMail",
      "returnFees": "https://schema.org/FreeReturn"
    }
  }
}
</script>

Os campos que mais confundem

merchantReturnDays é obrigatório quando returnPolicyCategory é MerchantReturnFiniteReturnWindow.
Não aceita devolução? Use https://schema.org/MerchantReturnNotPermitted. Também é uma política válida.
returnShippingFeesAmount só vai com ReturnShippingFees. Deixe de fora com FreeReturn ou ReturnFeesCustomerResponsibility.
applicableCountry aceita códigos de duas letras, até 50.
A política no produto aceita menos propriedades que a política na Organization.

Para reaproveitar uma política geral de outra página, dê à oferta só o @id dela, como "hasMerchantReturnPolicy": { "@id": "https://exemplo.com.br/trocas#politica" }.

Na sua plataforma

Shopify: o filtro structured_data do Dawn e do Horizon não escreve política de devolução. Troque o filtro por um bloco seu ou configure a política no Search Console.
WooCommerce com Rank Math: o Rank Math PRO coloca uma política geral em Rank Math SEO > Schema Templates > Add New Schema. Monte um MerchantReturnPolicy com o Custom Schema Builder e insira no schema Organization em Display Conditions. Sem o PRO, a documentação do Rank Math dá um filtro de código que coloca a política em cada oferta.
Wix, Squarespace e BigCommerce: no Wix, edite a marcação Product em SEO Settings > Products. No Squarespace a marcação não pode ser editada, então use o Search Console. No Cornerstone da BigCommerce, coloque a política em offers no arquivo templates/components/products/schema.html.

Confirme que funcionou

Teste um produto no Teste de pesquisa aprimorada e confira se a política de devolução aparece na parte de informações do produto do comerciante. Depois, clique em Validar a correção no problema, em Compras > Informações de produtos do comerciante.

Antes da política, o índice

A política de devolução só aparece para produtos que estão no índice do Google. O CrawlCoach mostra quais páginas da sua loja ficaram fora, e por quê.

Perguntas frequentes

hasMerchantReturnPolicy é obrigatório nas informações do comerciante?

Não. O Google lista como recomendado, e o Search Console mostra a falta como problema não crítico. Seus produtos podem aparecer sem ele.

E se a minha loja não aceita devolução?

Diga isso na marcação: use https://schema.org/MerchantReturnNotPermitted em returnPolicyCategory, com o seu applicableCountry. No Search Console, escolha sem devolução no prazo.

A política de devolução precisa estar em toda página de produto?

Não, para uma política geral. O Google recomenda uma política dentro da marcação Organization, numa página só. Os produtos podem apontar para ela pelo @id se você quer o aviso fora.

Fontes

Conferido em 8 de outubro de 2026. O Google muda o Search Console e a ajuda de tempos em tempos. Se algo estiver diferente na sua tela, confira a fonte.

O campo "hasMerchantReturnPolicy" não foi encontrado (em "offers"): como corrigir