Como Alterar a URL do WP Sem Quebrá-lo

Publicado em 12 de maio de 2026

Se você precisa alterar a URL do WP, faça isso em uma ordem controlada: primeiro faça backup, atualize o WordPress Address e o Site Address, depois corrija redirecionamentos, SSL e quaisquer links codificados manualmente. A maioria das falhas acontece não por causa da própria alteração da URL, mas porque os elementos ao redor dela ainda apontam para o local antigo. O site normalmente não está zangado — ele apenas está seguindo configurações desatualizadas.

Essa tarefa surge durante mudanças de domínio, passagem de HTTP para HTTPS, mudança do WordPress para um subdiretório ou migração de staging para produção. Para proprietários de lojas, agências e equipes de SaaS, uma alteração ruim de URL pode significar loops de login, avisos de mixed content, acesso ao admin quebrado ou formulários enviando para o lugar errado. Portanto, o objetivo não é apenas editar dois campos. O objetivo é manter toda a aplicação calma.

O que alterar a URL do WP realmente afeta

No WordPress, há duas configurações principais: WordPress Address e Site Address. Elas parecem semelhantes porque, francamente, são. Mas fazem trabalhos diferentes.

WordPress Address é onde os arquivos principais do WordPress ficam. Site Address é a URL pública que os visitantes usam para acessar o site. Em muitas configurações, elas são idênticas. Em outras, o WordPress pode estar em um subdiretório enquanto o site carrega a partir do domínio raiz.

Se você alterar uma delas incorretamente, o WordPress pode redirecioná-lo para longe do wp-admin, enviar assets para o domínio errado ou criar um loop infinito de redirecionamento. Plugins, temas, o banco de dados, o servidor web e as regras de CDN também podem ainda referenciar a URL anterior. É por isso que uma alteração correta é em parte trabalho no WordPress e em parte higiene de infraestrutura.

Antes de alterar a URL do WP

Faça um backup recente de arquivos e banco de dados. Se este for um site de e-commerce ou um site de conteúdo movimentado, faça o trabalho em uma janela de baixo tráfego. Uma alteração de URL pode afetar páginas em cache, cookies de sessão e callbacks de pagamento, então o momento importa.

Você também deve confirmar quatro coisas antes de fazer edições. Primeiro, o novo domínio ou protocolo já resolve para o servidor correto. Segundo, o certificado SSL está ativo se você estiver migrando para HTTPS. Terceiro, o virtual host do seu servidor web ou o server block do Nginx está pronto para o novo hostname. Quarto, você sabe se o WordPress está atrás de um proxy, load balancer ou CDN que possa forçar redirecionamentos.

Se algum desses itens não estiver pronto, o WordPress pode estar configurado corretamente e ainda assim falhar publicamente. Os logs então estão contando a mesma história.

As formas mais seguras de alterar a URL

Altere no admin do WordPress

Se você ainda tem acesso ao admin, este é o método mais limpo. Vá em Settings e depois em General. Atualize o WordPress Address e o Site Address para a nova URL. Salve as alterações.

Isso funciona bem quando a mudança é simples e o novo domínio já aponta corretamente para o site. Logo após salvar, faça login novamente se necessário e teste a página inicial, a área administrativa, a biblioteca de mídia e algumas páginas internas.

O risco é óbvio: se você inserir a URL errada, ou se o novo host ainda não estiver totalmente pronto, você pode ficar sem acesso ao painel.

Altere no wp-config.php

Se o painel não estiver acessível ou você quiser mais controle, defina os valores diretamente em wp-config.php. Adicione estas linhas acima da linha de parar de editar:

define('WP_HOME','https://example.com'); define('WP_SITEURL','https://example.com');

Isso força o WordPress a usar os valores do arquivo de configuração. Muitas vezes, é o método de recuperação mais rápido para loops de login ou redirecionamentos quebrados no admin.

Também é um bom estabilizador temporário durante migrações. Quando tudo estiver funcionando, você pode manter essas constantes no lugar ou removê-las e gerenciar os valores novamente pelo admin.

Altere no banco de dados

Se nem o admin nem a edição da configuração estiverem disponíveis, você pode atualizar os valores no banco de dados, geralmente na tabela wp_options. Os nomes das opções são home e siteurl.

Isso funciona, mas é mais manual e mais fácil de fazer mal se você estiver com pressa. Em sites com prefixos de tabela personalizados, não presuma que a tabela seja wp_options. Verifique primeiro.

HTTP para HTTPS é onde as pessoas se surpreendem

Muitos pedidos para alterar a wp url são, na verdade, migrações para HTTPS disfarçadas. A mudança visível parece pequena, mas navegadores, cookies e o carregamento de assets discordam.

Depois de mudar de HTTP para HTTPS nas configurações do WordPress, confirme que o certificado SSL é válido e está instalado para o hostname correto. Depois, atualize os redirecionamentos do seu servidor para que as requisições HTTP redirecionem permanentemente para HTTPS. Se o seu site estiver atrás de um reverse proxy ou CDN, certifique-se de que o WordPress consiga detectar HTTPS corretamente, caso contrário ele pode continuar redirecionando para sempre.

Mixed content é o próximo visitante habitual. As páginas carregam por HTTPS, mas imagens, scripts, fontes ou CSS ainda chamam URLs HTTP. Isso pode quebrar layouts ou acionar avisos do navegador. Você pode precisar de um search-and-replace no banco de dados para URLs absolutas antigas, especialmente se o site foi construído com um page builder ou com campos personalizados que armazenam links completos.

Pesquise e substitua URLs antigas com cuidado

Alterar as duas configurações principais não reescreve links antigos armazenados dentro de posts, metadados, conteúdo de widgets ou configurações de plugins. Se o domínio antigo aparecer codificado manualmente no banco de dados, os usuários ainda o acessarão.

É aqui que um search-and-replace adequado e seguro para serialized data faz diferença. Não execute uma substituição descuidada de texto simples em um arquivo SQL exportado e espere o melhor. Alguns dados de plugins e opções são serializados, e uma substituição ruim pode corromper comprimentos e quebrar configurações.

Se você estiver usando um fluxo de migração profissional, execute uma ferramenta que entenda a serialização do WordPress. Depois, verifique layouts do page builder, menus, URLs de imagens, canonical tags, configurações de Open Graph e qualquer plugin que armazene callback ou URLs de API.

Problemas comuns após uma alteração de URL

A página de login continua redirecionando

Isso geralmente significa que o WordPress, o servidor web ou um proxy está em desacordo sobre o scheme ou hostname corretos. Verifique WP_HOME e WP_SITEURL e depois inspecione as regras de redirecionamento do servidor. Se a terminação SSL acontecer upstream, o WordPress pode precisar que o cabeçalho HTTPS encaminhado seja tratado corretamente.

Os cookies também podem estar vinculados ao domínio antigo. Limpe os cookies do navegador e teste em uma janela privada antes de presumir que o site está amaldiçoado.

wp-admin está inacessível

Se a URL do admin enviar você para o local errado, force os valores corretos em wp-config.php. Isso frequentemente faz o painel voltar imediatamente. Revise também as regras do .htaccess ou do Nginx em busca de comportamento antigo de rewrite.

Imagens ou CSS estão quebrados

Isso aponta para URLs codificadas manualmente ou mixed content. Pesquise no banco de dados pelo domínio antigo e inspecione as ferramentas de desenvolvedor do navegador para ver quais assets ainda chamam a URL anterior.

Cadeias ou loops de redirecionamento

Eles geralmente acontecem quando o WordPress redireciona de um jeito e o servidor web ou a CDN redireciona de outro. Reduza a lógica a um único conjunto claro de regras. Se possível, trate o host canônico e os redirecionamentos para HTTPS em apenas um lugar.

Formulários, webhooks ou callbacks de checkout falham

Serviços externos ainda podem fazer post para o domínio antigo. Verifique URLs do gateway de pagamento, caminhos de retorno SMTP, endpoints de webhook e integrações de terceiros. Em sites de associação ou e-commerce, é aqui que ocorre dano silencioso à receita.

Quando WordPress Address e Site Address devem ser diferentes

A maioria dos sites deve mantê-los iguais. Mas há exceções válidas. Se o WordPress estiver instalado em um subdiretório como /wordpress, enquanto o site público carrega a partir da raiz do domínio, então o Site Address pode ser a URL raiz e o WordPress Address a URL do subdiretório.

Essa configuração pode ser útil para organização de arquivos, mas adiciona complexidade. Se você não está fazendo isso intencionalmente, não invente isso no meio da migração. Configurações simples falham com menos frequência.

Uma ordem prática que evita indisponibilidade

Use uma curta janela de manutenção, confirme DNS, SSL e a configuração do servidor primeiro, depois altere as URLs do WordPress. Depois disso, execute o search-and-replace no banco de dados, limpe os caches e teste caminhos principais: página inicial, admin, formulários, checkout, mídia, endpoints de API e comportamento do cron.

Se o site usa object caching, full-page caching ou uma CDN, purgue tudo após a alteração. Redirecionamentos antigos em cache podem fazer um site saudável parecer quebrado por mais 20 minutos, o que não é a situação de DNS mais bonita, mas está sob controle.

Para sites críticos para o negócio, prepare a alteração primeiro em staging. Na Kodu.cloud, este é exatamente o tipo de tarefa em que o suporte gerenciado de infraestrutura se paga sozinho — não porque alterar uma URL seja impossível, mas porque as pequenas verificações ao redor são o que evitam as surpresas desagradáveis.

Verificações finais após alterar a URL do WP

Abra o site em uma nova sessão do navegador e teste tanto com quanto sem www, se for relevante. Confirme o cadeado SSL, inspecione algumas URLs de origem e certifique-se de que o admin, o login, os uploads de mídia e os formulários de contato se comportam normalmente. Se os mecanismos de busca já indexaram o domínio antigo, mantenha os redirecionamentos adequados em vigor por tempo suficiente para que o tráfego e os sinais de ranking sejam transferidos corretamente.

Uma alteração da URL do WP geralmente é um trabalho curto quando o ambiente está pronto. Ela se torna uma noite longa apenas quando DNS, SSL, regras do servidor, cache e referências no banco de dados são deixados para discutir entre si. Mantenha todos na mesma direção, e o serviço ficará calmo novamente.

Andres Saar Engenheiro de Customer Care