Depois de fazeres push de um site de staging para produção, o Yoast SEO pode manter o domínio de staging como URL canónica — ou remover a canónica por completo. A solução é reconstruir os indexables do Yoast para que ele regenere cada canónica em relação ao teu domínio em produção, e definir a canónica manualmente em qualquer página individual que continue errada.
Porque é que as URLs canónicas do Yoast ficam erradas após uma migração do site?
O Yoast SEO não calcula as URLs canónicas a cada carregamento de página. Guarda-as nos seus indexables — uma cache de dados de SEO mantida na tabela da base de dados wp_yoast_indexable, mais valores por artigo em wp_postmeta. Quando fazes push de um site de staging para o teu site de produção, essas linhas viajam com a base de dados.
Se os indexables foram construídos enquanto o site ainda usava o domínio de staging, contêm URLs de staging. Após o push, vês um de dois sintomas:
- A etiqueta
rel="canonical"aponta para a URL de staging (por exemplo,https://staging.example.com/page/em vez dehttps://example.com/page/). - A etiqueta canónica está em falta em algumas páginas, porque a linha do indexable guardada está desatualizada ou incompleta.
A causa são os dados de indexables em cache, e não uma instalação do Yoast danificada. O Yoast emite automaticamente uma canónica autorreferenciada para cada artigo e página públicos — não existe um interruptor global para ligar ou desligar. Por isso, o objetivo é levar o Yoast a reconstruir essa cache em relação ao domínio correto.
Como corrijo a URL canónica de uma única página no Yoast SEO?
Se apenas uma ou poucas páginas forem afetadas, substitui a canónica diretamente no editor:
- Abre a página ou artigo afetado no editor do WordPress.
- Na barra lateral do Yoast SEO (ou na meta box do Yoast por baixo do conteúdo), abre o separador Avançado.
- Localiza o campo URL canónica.
- Introduz a URL de produção correta — ou limpa o campo para deixar o Yoast recorrer à sua canónica autorreferenciada predefinida em relação ao teu domínio em produção.
- Atualiza a página.
Deixar o campo vazio é normalmente a escolha certa: uma canónica autorreferenciada é o que a maioria das páginas deve ter. Só deves introduzir uma URL explícita quando a página deve apontar para uma canónica diferente (por exemplo, uma página sindicada ou duplicada).
Como corrijo em massa as URLs canónicas após uma migração completa do site?
Quando muitas páginas carregam o domínio de staging, corrigi-las uma a uma é impraticável. Em vez disso, reconstrói todos os indexables de uma só vez.
Opção 1: repor e reotimizar os dados de SEO do Yoast
- Instala e ativa o plugin Yoast Test Helper.
- Vai a Ferramentas → Yoast Test.
- Clica em Reset Indexables & Migrations. Isto limpa os indexables em cache para que o Yoast os reconstrua de raiz.
- Vai a SEO → Ferramentas e clica em Start SEO data optimization. O Yoast regenera cada indexable — incluindo as URLs canónicas — em relação ao teu domínio atual (de produção).
- Desativa o plugin Yoast Test Helper assim que a otimização terminar; é uma ferramenta de programador, não deve permanecer ativa.
Opção 2: reconstruir os indexables com WP-CLI
Se tiveres acesso à shell, a mesma reconstrução corre a partir da linha de comandos:
wp yoast indexIsto reindexa todos os indexables do Yoast para o site atual. É mais rápido do que o otimizador via navegador em sites grandes e seguro para voltar a executar.
Depois de qualquer das opções, limpa todas as caches — o teu plugin de cache, a cache do servidor e o CDN — para que visitantes e rastreadores recebam as etiquetas canónicas corrigidas em vez de uma cópia em cache das antigas.
Mais uma coisa a verificar: confirma que foi executado um find-and-replace na base de dados durante o push, trocando o domínio de staging pelo domínio de produção. O WP STAGING faz isto automaticamente quando fazes push, mas se importaste a base de dados de outra forma, um domínio de staging que tenha sobrado nos dados é a causa raiz que reconstruir os indexables, por si só, não resolve.
Como evito problemas de URL canónica no próximo push?
- Deixa o WP STAGING tratar da reescrita do domínio. Quando fazes push com o WP STAGING, ele executa um find-and-replace em toda a base de dados, incluindo os dados do Yoast. Evita importações manuais da base de dados que saltem este passo.
- Reconstrói os indexables após cada push. Faz de "Reset Indexables & Migrations + SEO data optimization" (ou
wp yoast index) parte da tua checklist pós-push. - Nunca fixes uma canónica por página para o domínio de staging. Se definiste uma canónica explícita durante os testes em staging, limpa-a antes do push para que a página de produção recorra a uma canónica autorreferenciada.
Para contexto sobre por que as etiquetas canónicas são importantes, consulta as orientações da Google sobre consolidar URLs duplicadas e a explicação do Yoast sobre rel="canonical".
Perguntas frequentes
Repor os indexables do Yoast vai apagar as minhas definições de SEO?
Não. Repor os indexables limpa apenas os dados de SEO em cache. O Yoast reconstrói-os a partir dos teus artigos e definições existentes, pelo que os teus títulos, meta descrições, palavras-chave de foco e configuração permanecem intactos.
Porque é que a minha URL canónica está vazia após uma migração?
Uma canónica em falta significa quase sempre que a linha do indexable da página está desatualizada ou não foi regenerada em relação ao novo domínio. Reconstruir os indexables (opção 1 ou 2 acima) restaura a canónica autorreferenciada.
Preciso do plugin Yoast Test Helper para corrigir isto?
É a forma mais fácil de repor indexables e migrações a partir do painel de administração do WordPress. Se preferires a linha de comandos, o wp yoast index faz a reconstrução sem qualquer plugin extra. De qualquer forma, o objetivo é o mesmo: forçar o Yoast a regenerar os seus dados de SEO em cache.
Isto aplica-se tanto ao Yoast SEO Free como ao Premium?
Sim. Os indexables existem tanto na versão gratuita como na versão Premium do Yoast SEO, pelo que o mesmo processo de repor e reconstruir corrige as URLs canónicas em qualquer uma delas.
