# Como corrigir a importação de dados do Yoast para o SEOPress no WordPress

O erro ao importar o Yoast para o SEOPress acontece quando a migração em SEO > Ferramentas > Plugins não conclui ou não traz títulos, meta descriptions e focus keywords, geralmente por rodar os dois plugins ao mesmo tempo, versão antiga do SEOPress ou processo interrompido por timeout.

## O que é importação do Yoast para SEOPress?

Importar dados do Yoast para o SEOPress é o processo de migração que copia os metadados de SEO já gravados pelo Yoast (títulos, meta descriptions, robots, canonical, focus keyword, categoria primária e tags Open Graph) para os campos próprios do SEOPress. Segundo a documentação oficial do SEOPress, a migração é feita em SEO > Ferramentas > Plugins, selecionando Yoast SEO e clicando em Migrate now. Os dados do Yoast não são apagados, mas os metadados que o SEOPress já tiver são sobrescritos pela importação.

O erro aparece quando essa migração não termina ou não traz os campos esperados: o botão Migrate now roda mas os títulos e descrições continuam vazios no SEOPress, o focus keyword some, ou a barra de progresso trava no meio. Como o SEOPress lê os metadados pelas suas próprias chaves (por exemplo _seopress_titles_title), enquanto o Yoast usa as chaves dele (_yoast_wpseo_title), nada aparece no front-end nem nas metaboxes até a importação rodar até o fim e mapear cada campo corretamente.

## Como identificar

- Após clicar em 'Migrate now', os campos de título e meta description do SEOPress continuam vazios em todos os posts e páginas.
- A barra de progresso da migração trava em uma porcentagem e a página exibe 'An error occurred during the import' ou simplesmente para de avançar.
- Os focus keywords e a categoria primária definidos no Yoast não aparecem nas metaboxes do SEOPress depois da importação.
- No código-fonte das páginas surgem duas tags de title ou duas meta description (uma do Yoast e outra do SEOPress) porque os dois plugins ficaram ativos ao mesmo tempo.
- A tela de migração mostra a mensagem 'Migration will delete/upgrade all SEOPress posts metadata' e, ao confirmar, nenhum dado do Yoast é trazido.

**Antes de começar:** Antes de rodar o Migrate now, faça um backup completo do banco de dados ou teste primeiro em um ambiente de staging. A própria tela do SEOPress avisa que a migração sobrescreve os metadados de SEO existentes do plugin, e isso não tem desfazer pela interface.

## Como prevenir

- Configure as opções básicas do SEOPress somente depois de importar do Yoast, já que rodar o Migrate now sobrescreve os metadados existentes do SEOPress.
- Nunca mantenha Yoast e SEOPress ativos juntos por mais tempo que o necessário para a migração, pois dois plugins de SEO geram títulos e meta descriptions duplicados.
- Antes de migrar sites grandes, ajuste max_execution_time e memory_limit do PHP para evitar que a importação pare no meio por timeout.
- Sempre faça backup do banco de dados antes de clicar em Migrate now, porque a importação não tem botão de desfazer na interface do SEOPress.

Erros relacionados

- [Como corrigir schema markup quebrado no WordPress](https://full.services/wp-fixer/corrigir-schema-markup-quebrado-wordpress/)
- [Como corrigir meta description não aparecendo no Google](https://full.services/wp-fixer/corrigir-meta-description-nao-aparece-wordpress/)
- [Como corrigir URLs canonicas duplicadas no WordPress](https://full.services/wp-fixer/corrigir-canonical-duplicado-wordpress/)

## Causa

- Yoast SEO e SEOPress estão ativos ao mesmo tempo durante a migração: a documentação do SEOPress alerta para não rodar dois plugins de SEO juntos, o que gera tags duplicadas e leitura inconsistente dos metadados na importação.
- A versão do SEOPress é anterior à 8.7, que passou a importar também as configurações globais (Global settings) do Yoast; em versões antigas parte dos dados simplesmente não é mapeada no Migrate now.
- O processo de importação foi interrompido por timeout do PHP (max_execution_time) ou limite de memória em sites com muitos posts, deixando a migração pela metade e os campos do SEOPress vazios.
- A migração foi rodada uma vez e sobrescreveu os metadados do SEOPress com valores vazios; como a tela avisa que 'Migration will delete/upgrade all SEOPress posts metadata', rodar antes de configurar o SEOPress apaga o que já existia.
- Os metadados do Yoast estão sob chaves de meta diferentes do esperado (por exemplo conteúdo importado de outro plugin ou multisite), então o mapeamento _yoast_wpseo_* para _seopress_* não encontra os valores e nada é importado.

## Como resolver

1. Faça backup antes de migrar: A tela de migração avisa que os metadados existentes do SEOPress serão sobrescritos. Faça um backup do banco de dados antes de clicar em Migrate now para poder reverter se a importação trouxer campos vazios.

```
Painel WP -> use seu plugin de backup (ex.: UpdraftPlus) -> Backup Now
Marque a opção de incluir o banco de dados no backup
```

2. Atualize o SEOPress para 8.7 ou superior: A importação das configurações globais do Yoast só existe a partir do SEOPress 8.7. Atualize o plugin antes de migrar para garantir que títulos, descrições e ajustes globais sejam mapeados.

```
Painel WP -> Plugins -> verifique a versão do SEOPress (alvo: 8.7+)
Clique em Atualizar agora se houver versão mais recente
```

3. Rode o Migrate now com o Yoast ainda ativo: Mantenha o Yoast ativo durante a migração para que o SEOPress consiga ler os metadados dele. Vá em SEO -> Ferramentas -> aba Plugins, selecione Yoast SEO e clique em Migrate now, aguardando a barra de progresso chegar a 100 por cento.

```
Painel WP -> SEO (SEOPress) -> Ferramentas -> aba Plugins
Selecione 'Yoast SEO' e clique em 'Migrate now'
Aguarde a barra de progresso concluir antes de sair da página
```

4. Aumente os limites do PHP se a migração travar: Em sites grandes a importação pode estourar o tempo ou a memória do PHP e parar no meio. Aumente max_execution_time e memory_limit e rode o Migrate now novamente do início.

```
Edite o wp-config.php ou php.ini do servidor
Defina memory_limit = 256M e max_execution_time = 300
Salve, recarregue a tela de Ferramentas e rode 'Migrate now' de novo
```

5. Confira os dados e desative o Yoast: Abra alguns posts e verifique se título, meta description e focus keyword apareceram na metabox do SEOPress. Confirmado, desative e remova o Yoast para não manter dois plugins de SEO rodando juntos.

```
Painel WP -> abra 2 ou 3 posts -> confira a metabox do SEOPress
Painel WP -> Plugins -> Desativar o Yoast SEO
Após validar, clique em Excluir para remover o Yoast
```


## Código

```bash
# Confirma se o Yoast realmente gravou os metadados nos posts
wp post meta list 123 --keys=_yoast_wpseo_title,_yoast_wpseo_metadesc,_yoast_wpseo_focuskw

# Lista quantos posts ainda tem titulo do Yoast pendente de importacao
wp db query "SELECT COUNT(*) FROM wp_postmeta WHERE meta_key='_yoast_wpseo_title';"

# Apos o Migrate now, verifica se o SEOPress gravou o titulo no mesmo post
wp post meta get 123 _seopress_titles_title
```

## Perguntas frequentes

### Por que o SEOPress não importou meus títulos e meta descriptions do Yoast

Na maioria das vezes a migração foi interrompida ou rodou com os dois plugins em conflito. Vá em SEO, Ferramentas, aba Plugins, selecione Yoast SEO e rode o Migrate now novamente, aguardando a barra chegar a 100 por cento antes de sair da página.

### Preciso do SEOPress PRO para importar do Yoast

Não. A importação básica de metadados de posts e termos do Yoast para o SEOPress está disponível na versão gratuita. As configurações globais do Yoast passaram a ser importadas a partir do SEOPress 8.7, então mantenha o plugin atualizado.

### A importação apaga os dados do Yoast

Não. Segundo a documentação do SEOPress, a migração não deleta os dados do Yoast, apenas copia para os campos do SEOPress. O que é sobrescrito são os metadados que o próprio SEOPress já tivesse gravado nos posts.

### Devo desativar o Yoast antes ou depois de migrar

Depois. Mantenha o Yoast ativo durante o Migrate now para o SEOPress conseguir ler os metadados dele. Só desative e remova o Yoast após confirmar que título, descrição e focus keyword apareceram nas metaboxes do SEOPress.

### A migração travou no meio, o que fazer

Em sites grandes a importação pode estourar o tempo de execução do PHP. Aumente o max_execution_time e o memory_limit no servidor e rode o Migrate now novamente do início, já que ele reprocessa os posts a partir do começo.

### Quais dados do Yoast o SEOPress consegue importar

O SEOPress importa títulos, meta descriptions, tags Open Graph e X, robots como noindex e nofollow, URL canônica, focus keyword, categoria primária e o título do breadcrumb. A partir da versão 8.7 também traz as configurações globais do Yoast.

### Por que aparecem duas meta description no código da página

Isso ocorre quando Yoast e SEOPress ficam ativos ao mesmo tempo após a migração, cada um imprimindo a sua tag. Desative e exclua o Yoast assim que confirmar que os dados foram importados para o SEOPress.

### Como importo as redirecionamentos do Yoast Premium para o SEOPress

Os redirecionamentos não vêm pelo Migrate now de metadados. Exporte o arquivo do Yoast Premium e importe em SEO, Ferramentas, aba Redirecionamentos do SEOPress, fazendo o upload do arquivo gerado pelo Yoast.

**Fonte:** [SEOPress — Import post and terms metadata, global settings from Yoast SEO to SEOPress](https://www.seopress.org/support/guides/import-post-terms-metadatas-yoast-seo-seopress/)