Como rodar o WordPress em um subdiretório sem quebrar os links do site
Oi! Aqui é a Sensei da GeHost 🌿 Vamos falar de um cenário bem comum: você quer manter o WordPress rodando dentro de uma pasta (tipo seusite.com.br/blog ou seusite.com.br/loja) em vez de ficar direto na raiz do domínio. Isso é super normal quando o site principal é uma landing page estática e o WordPress cuida só de uma parte dele.
O perigo mora nos detalhes: se você mexer nisso sem cuidado, o WordPress "esquece" onde ele está e todos os links, imagens e menus quebram. Mas com calma e seguindo os passos certos, dá pra fazer isso sem dor de cabeça. Bora lá?
Antes de começar: entenda a diferença entre "onde estão os arquivos" e "qual é o endereço do site"
Esse é o pulo do gato de todo esse processo. O WordPress trabalha com dois conceitos separados:
- Endereço do WordPress (site URL): onde ficam os arquivos principais do sistema (o "motor" do WordPress).
- Endereço do site (home URL): o que aparece na barra de endereço do visitante quando ele acessa seu site.
A mágica de rodar o WordPress em um subdiretório sem quebrar links está em deixar os arquivos do WordPress dentro da subpasta, mas configurar o "endereço do site" para ser a raiz do domínio (ou vice-versa, dependendo do seu objetivo). Vamos ver os dois cenários mais comuns.
💡 Dica da Sensei: antes de qualquer alteração, faça um backup completo do site (arquivos + banco de dados). Isso é rotina básica de segurança — assim, se algo sair diferente do esperado, você volta pro estado anterior em minutos.
Cenário 1: o WordPress vai controlar todo o site, mas os arquivos ficam numa subpasta
Esse é o caso mais comum: você quer que o visitante acesse seusite.com.br normalmente (sem precisar digitar "/blog"), mas por organização os arquivos do WordPress ficam guardados dentro de uma subpasta, tipo public_html/wordpress.
- No painel do WordPress, vá em Ajustes → Geral.
- No campo "Endereço do WordPress (URL)", mantenha o endereço com a subpasta (ex.: seusite.com.br/wordpress).
- No campo "Endereço do Site (URL)", coloque o endereço sem a subpasta (ex.: seusite.com.br).
- Salve as alterações.
Depois disso, você precisa copiar (não mover!) o arquivo index.php de dentro da subpasta do WordPress para a pasta raiz (public_html). Abra esse index.php copiado na raiz com um editor de texto e altere a linha que chama o wp-blog-header.php, apontando para o caminho da subpasta. O próprio WordPress explica esse ajuste na documentação oficial dele — é só uma linha de código, nada complicado.
Você pode fazer essa cópia e edição direto pelo Gerenciador de Arquivos do seu painel de hospedagem, sem precisar de FTP:
Cenário 2: você realmente quer o WordPress vivendo só dentro da subpasta (ex.: seusite.com.br/blog)
Aqui o objetivo é diferente: o visitante vai mesmo digitar "/blog" para chegar no WordPress, porque a raiz do domínio é ocupada por outra coisa (um site institucional, uma landing page, etc.).
- Instale o WordPress diretamente dentro da subpasta desejada (ex.: public_html/blog).
- Em Ajustes → Geral, deixe os dois campos ("Endereço do WordPress" e "Endereço do Site") apontando para o mesmo caminho, incluindo a subpasta — ex.: seusite.com.br/blog nos dois.
- Salve e teste o acesso pelo navegador.
Nesse cenário, como tudo — arquivos e endereço — está alinhado na mesma subpasta, o risco de link quebrado é bem menor. O problema geralmente aparece quando alguém migra um site que já estava na raiz para dentro de uma subpasta (ou o contrário) sem seguir os dois campos do Cenário 1 corretamente.
Depois de configurar: os 3 passos que salvam seus links
- Atualize os links permanentes. Vá em Ajustes → Links Permanentes, mesmo sem mudar nada, e clique em Salvar alterações. Isso força o WordPress a reescrever as regras de URL considerando o novo endereço.
- Verifique o arquivo .htaccess. Ele também precisa refletir o caminho correto da subpasta. Na maioria dos casos, o passo acima já regenera esse arquivo sozinho — mas vale conferir pelo Gerenciador de Arquivos se ele existe e não está com permissão bloqueada.
- Rode uma busca e substituição no banco de dados, se necessário. Se o site já tinha conteúdo publicado com o endereço antigo (imagens, links internos em textos de posts, etc.), você vai precisar trocar as URLs antigas pelas novas dentro do banco de dados. Isso costuma ser feito com um plugin de "busca e substituição" (Search & Replace) direto pelo painel do WordPress — é bem mais seguro do que editar o banco na mão.
⚠️ Atenção: nunca troque a URL só editando textos "no olho" dentro dos posts. Como o WordPress guarda referências em vários lugares (menus, widgets, campos de imagem em destaque, configurações de tema), o caminho seguro é sempre pelos Ajustes → Geral + uma ferramenta de busca e substituição no banco.
Erros comuns que quebram os links (e como evitar)
- Mudar só um dos dois campos em Ajustes → Geral. Os dois precisam estar coerentes com o cenário escolhido — um decide onde o motor mora, o outro decide o que o visitante vê.
- Esquecer de copiar o index.php para a raiz (no Cenário 1). Sem ele, a raiz do domínio simplesmente não vai carregar nada.
- Mover, em vez de copiar, arquivos como wp-config.php. Fique atento a qual arquivo o tutorial pede pra copiar e qual pede pra manter — mover o arquivo errado pode derrubar o site.
- Não testar em uma aba anônima do navegador depois da mudança — o cache do seu próprio navegador pode te enganar, fazendo parecer que nada mudou (ou que quebrou) quando na real só é cache antigo.
Se algo der errado
Respire — isso tem conserto. Se o site ficar em branco ou der erro após a mudança, o caminho mais rápido é reverter os campos em Ajustes → Geral para os valores anteriores (você pode fazer isso também direto no banco de dados, na tabela wp_options, alterando as linhas siteurl e home, caso não consiga nem acessar o painel). Se preferir, é só acionar o suporte da GeHost e a gente ajuda a diagnosticar com calma.
Combinado? Um passo de cada vez, sempre com backup na manga. 🌱
