# 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.

## O que é Local SEO do SEOPress que não funciona?

O Local SEO do SEOPress é o recurso que descreve o seu negócio local para os buscadores. Ele gera o schema LocalBusiness (dados estruturados com nome, endereço, telefone e horário de funcionamento), oferece um widget de negócio local e um bloco do Gutenberg para exibir essas informações no site, segundo a documentação oficial do plugin. O objetivo é aumentar as chances de aparecer no painel de conhecimento do Google e reforçar os sinais de E-E-A-T da página.

O Local SEO do SEOPress é um recurso premium: ele depende da versão PRO com a licença ativada. Quando o módulo está desligado, sem licença válida, com campos essenciais vazios ou com o schema retido por uma camada de cache, o negócio local deixa de ser descrito. Na prática isso aparece como o bloco Local Business sem renderizar no editor, o widget vazio no front-end ou o dado estruturado LocalBusiness ausente quando você testa a URL no validador de Resultados Ricos do Google.

## Como identificar

- O bloco 'Local Business' do SEOPress não aparece na lista do inserter (botão + 'Adicionar bloco') ou exibe a mensagem 'This block has encountered an error and cannot be previewed' no editor.
- O validador de Resultados Ricos do Google ('Rich Results Test') ou o Schema.org Validator não detecta o tipo LocalBusiness na URL da página.
- O widget de negócio local fica em branco no front-end, sem mostrar endereço, telefone ou horário de funcionamento.
- O Google Search Console reporta 'LocalBusiness' com campos ausentes ou marca o item estruturado como inválido.
- O menu 'Local Business' não aparece em SEO PRO no painel, indicando que o módulo PRO está inativo ou sem licença.

**Antes de começar:** Antes de ativar ou desativar módulos do SEOPress, trocar plugins de SEO ou mexer no cache em produção, faça um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para reverter caso o schema ou o layout da página quebrem.

## Como prevenir

- Mantenha a SEOPress PRO com a licença ativa e renovada, já que o Local SEO depende do plugin premium para emitir o schema LocalBusiness.
- Use apenas um plugin de SEO emitindo dados estruturados por vez, evitando schema duplicado entre SEOPress e Rank Math ou Yoast.
- Revise os campos do negócio local (endereço, telefone e horário) sempre que a empresa mudar de dados, para o schema não ficar desatualizado.
- Inclua a limpeza de cache do plugin e da CDN no checklist de toda alteração de SEO, para o HTML com o schema novo chegar ao Google.
- Valide a URL no Teste de Resultados Ricos após qualquer mudança no Local Business, confirmando que o LocalBusiness segue sem erros.

Erros relacionados

- [Como corrigir o erro de schema markup no SEOPress](https://full.services/wp-fixer/corrigir-schema-markup-seopress/)
- [Como corrigir os breadcrumbs que não exibem no SEOPress](https://full.services/wp-fixer/corrigir-breadcrumbs-seopress/)
- [Como corrigir o sitemap XML que não gera no SEOPress](https://full.services/wp-fixer/corrigir-sitemap-xml-seopress/)

## Causa

- A versão instalada é a gratuita do SEOPress, ou a SEOPress PRO está sem a licença ativada em SEO PRO -> Licença: a documentação oficial classifica o Local SEO como recurso premium, então sem PRO ativo o módulo Local Business não emite o schema.
- O módulo Local Business está desligado nas configurações do SEOPress PRO, então o plugin não imprime o dado estruturado LocalBusiness mesmo com a licença válida.
- Campos obrigatórios do negócio local estão em branco (nome da empresa, tipo de negócio, endereço, telefone ou horário de funcionamento), e sem esses dados mínimos o schema LocalBusiness sai incompleto e o Google o rejeita.
- Um plugin de cache ou a CDN está servindo uma versão antiga do HTML, gravada antes de você preencher o Local Business, então o schema atualizado não chega ao Google nem ao navegador.
- Outro plugin de SEO ativo ao mesmo tempo (Rank Math, Yoast) também emite schema, gerando dado estruturado duplicado ou conflitante que invalida o LocalBusiness do SEOPress.
- O bloco ou o shortcode de negócio local não foi inserido em nenhuma página publicada, então não existe ponto no site onde o widget e o schema do Local Business sejam renderizados.

## Como resolver

1. Confirme a SEOPress PRO com licença ativa: O Local SEO é um recurso premium na documentação oficial. Verifique se o SEOPress PRO está instalado além do plugin gratuito e se a licença foi ativada, pois sem isso o módulo Local Business não emite o schema.

```
Painel WP -> Plugins -> confirme 'SEOPress PRO' instalado e ativo
Painel WP -> SEO PRO -> Licença -> cole a chave e clique em Ativar licença
```

2. Ative o módulo Local Business e o schema LocalBusiness: Com a PRO ativa, ligue o recurso de negócio local nas configurações do SEOPress para que o plugin passe a imprimir o dado estruturado LocalBusiness no site.

```
Painel WP -> SEO -> Dados estruturados (ou Local Business no SEOPress PRO)
Habilite a opção de Local Business / LocalBusiness e salve as alterações
```

3. Preencha os campos obrigatórios do negócio local: Informe nome da empresa, tipo de negócio, endereço completo, telefone e horário de funcionamento. Sem esses dados mínimos o schema LocalBusiness sai incompleto e o Google o ignora.

```
Painel WP -> SEO -> Local Business
Preencha tipo de negócio, endereço, telefone e horário de funcionamento
Salve e confirme que nenhum campo essencial ficou em branco
```

4. Insira o bloco ou shortcode de negócio local na página: Adicione o bloco Local Business do SEOPress (também disponível no Elementor e no Editor de Site Completo) na página de contato ou na home, para que o widget e o schema sejam de fato renderizados.

```
Editor de blocos -> botão + -> procure por 'Local Business' (SEOPress)
Ou cole o shortcode de negócio local fornecido pelo SEOPress no conteúdo
Publique ou atualize a página
```

5. Limpe o cache e desfaça conflito de schema: Esvazie o cache do plugin de cache e da CDN para o HTML novo subir, e desative o schema de qualquer outro plugin de SEO ativo, evitando dado estruturado duplicado que invalida o LocalBusiness.

```
Painel WP -> plugin de cache -> Limpar cache / Purgar tudo
Cloudflare ou CDN -> Purge Everything
Desative a saída de schema de outro plugin de SEO (Rank Math/Yoast) se houver
```

6. Valide o schema na URL pública: Teste a URL publicada no Teste de Resultados Ricos do Google e no Schema.org Validator para confirmar que o tipo LocalBusiness é detectado e sem erros de campo obrigatório.

```
Abra https://search.google.com/test/rich-results e informe a URL
Abra https://validator.schema.org e cole a mesma URL
Confirme que o item LocalBusiness aparece sem avisos de campo ausente
```


## Código

```php
<?php
// Diagnostico: confirma se a SEOPress PRO esta ativa antes de depender do Local Business.
add_action( 'admin_notices', 'full_seopress_local_seo_check' );
function full_seopress_local_seo_check() {
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    // A constante so existe quando o SEOPress PRO esta carregado.
    if ( ! defined( 'SEOPRESS_PRO_VERSION' ) ) {
        echo '<div class="notice notice-warning"><p>';
        echo 'Local SEO indisponivel: SEOPress PRO inativo. O schema LocalBusiness exige a versao PRO com licenca ativa.';
        echo '</p></div>';
    }
}
```

## Perguntas frequentes

### Por que o Local SEO do SEOPress não aparece no meu site

Quase sempre porque o recurso é premium e exige a SEOPress PRO com licença ativa, ou porque os campos do negócio local estão vazios. Ative a PRO, preencha endereço, telefone e horário e insira o bloco Local Business em uma página publicada.

### O Local SEO do SEOPress é gratuito ou precisa do PRO

Precisa do PRO. A documentação oficial do SEOPress classifica o Local Business schema, o widget e o bloco de negócio local como recursos premium, disponíveis apenas com a versão SEOPress PRO instalada e licenciada.

### Por que o schema LocalBusiness não passa no Teste de Resultados Ricos do Google

Em geral falta um campo obrigatório do negócio (endereço, telefone ou horário) ou há schema duplicado de outro plugin de SEO. Complete os campos no Local Business e deixe apenas um plugin emitindo dados estruturados, depois revalide a URL.

### O bloco Local Business do SEOPress não renderiza no editor, o que fazer

Confirme que a SEOPress PRO está ativa e atualizada, pois o bloco é parte do recurso premium. Se ainda quebrar, limpe o cache do navegador e do site e teste com um tema padrão para descartar conflito de JavaScript no editor de blocos.

### Limpar o cache resolve o Local SEO do SEOPress

Resolve quando o problema é HTML antigo. Se você preencheu o Local Business mas o schema não aparece, o cache do plugin ou da CDN pode estar servindo a versão anterior. Purgue o cache e a CDN e teste a URL de novo no validador.

### Posso usar SEOPress e Rank Math juntos para o Local Business

Não é recomendado emitir schema pelos dois ao mesmo tempo. Dois plugins gerando dados estruturados criam LocalBusiness duplicado ou conflitante, o que o Google rejeita. Escolha um para o schema e desative a saída de dados estruturados do outro.

### O Local Business do SEOPress funciona com Elementor e o Editor de Site Completo

Sim. A documentação oficial informa que o widget de negócio local também está disponível no Elementor e que o bloco Local Business funciona com o recurso de Edição de Site Completo (Full Site Editing), além do editor de blocos padrão.

**Fonte:** [SEOPress — Local SEO (Local Business schema, widget e bloco)](https://www.seopress.org/features/local-seo/)