# WPML: Tutorial completo em 6 passos para WordPress

O <strong>WPML</strong> deixa o WordPress multilíngue gerenciando idiomas, tradução de páginas e hreflang num só painel. Segundo o <a href="https://developers.google.com/search/docs/specialty/international/localized-versions">Google Search Central (2024)</a>, o hreflang indexa cada idioma sem punir conteúdo duplicado. A licença é anual e recorrente, com 4 módulos opcionais. Configure idiomas, traduza e valide o SEO antes de publicar.

O WPML é o plugin que transforma um site WordPress de idioma único em um site multilíngue, com tradução de páginas, posts, menus, textos do tema e URLs separadas por idioma. Diferente de traduzir na mão, ele cria uma estrutura de idiomas conectados, em que cada página em português tem sua versão em inglês ou espanhol amarrada por hreflang. A gente vê no suporte da FULL que a maioria dos sites que tentam virar multilíngue sem plano travam no SEO: URLs duplicadas, menu só em português e cache servindo o idioma errado. Este tutorial de WPML mostra os 6 passos para evitar isso. Para o panorama do tema, consulte os <a href="https://full.services/wordpress-multilingue/">conteúdos de WordPress multilíngue da FULL</a>.

---

## Visão geral do WPML: O que cada módulo faz

O WPML 4.6 não é um plugin único: são quatro módulos que você ativa conforme a necessidade. O núcleo (Multilingual CMS) gerencia idiomas e URLs, o String Translation traduz textos do tema, o Translation Management organiza tradutores e o Media Translation troca imagens. Numa instalação típica, núcleo mais String Translation cobrem a maioria dos casos.

A tabela abaixo resume o que cada peça entrega e quando ativar, para você não instalar módulo que não vai usar e ainda pesar no banco do site.

<table id="modulos-wpml">
<caption>WPML: módulos, função e quando ativar</caption>
<thead>
<tr><th scope="col">Módulo</th><th scope="col">Função principal</th><th scope="col">Quando ativar</th></tr>
</thead>
<tbody>
<tr><th scope="row">Multilingual CMS</th><td>Idiomas, URLs e hreflang</td><td>Sempre, é a base</td></tr>
<tr><th scope="row">String Translation</th><td>Textos do tema e widgets</td><td>Tema com texto fixo</td></tr>
<tr><th scope="row">Translation Management</th><td>Fluxo de tradutores</td><td>Equipe ou agência</td></tr>
<tr><th scope="row">Media Translation</th><td>Imagens por idioma</td><td>Banners com texto</td></tr>
</tbody>
</table>

Para entender a estrutura geral antes de mexer no plugin, vale ler o <a href="https://full.services/guia-para-criar-um-site-multilingue-no-wordpress/">guia para criar um site multilíngue no WordPress</a>, que cobre o planejamento antes da instalação.

## Por que escolher o WPML e não apenas traduzir na mão

Traduzir na mão quebra o SEO internacional, e é por isso que o WPML existe. Quando você duplica uma página e troca o texto sem hreflang, o Google trata as duas URLs como conteúdo concorrente e tende a indexar só uma. Nos casos que chegam ao suporte da FULL, esse é o erro número um: o site tem versão em inglês, mas ela nunca ranqueia.

O WPML resolve isso gerando o hreflang automaticamente e mantendo cada tradução amarrada ao original, o que o <a href="https://developers.google.com/search/docs/specialty/international/localized-versions">Google Search Central</a> aponta como a forma correta de sinalizar versões. Sem o WPML, cada post vira dois trabalhos manuais desconectados; com ele, o <a href="https://full.services/glossario/seo-internacional/">SEO internacional</a> nasce estruturado. O <a href="https://full.services/glossario/plugin-wordpress/">plugin WordPress</a> também traduz menus e taxonomias, e o artigo sobre <a href="https://full.services/como-traduzir-seu-site-wordpress-em-varios-idiomas/">como traduzir seu site WordPress em vários idiomas</a> mostra onde ele ganha do método improvisado.

## Como instalar e configurar o WPML em 6 passos

Instalar o WPML leva cerca de 15 minutos, mas a configuração de idiomas e URLs define todo o SEO do site. O assistente do plugin guia a maior parte, porém duas escolhas são irreversíveis na prática: o formato de URL por idioma e o idioma padrão. Erre nelas e você refaz tudo.

Antes de começar, faça backup, confirme que está no WordPress 6.5 ou superior com PHP 8.2 e tenha a chave da licença em mãos. Os seis passos abaixo seguem a ordem que reduz retrabalho: primeiro a base, depois os idiomas, o formato de URL e só então a tradução de conteúdo e textos do tema.

### Passo 1: Instale o núcleo do WPML

Baixe o WPML Multilingual CMS na sua conta wpml.org, vá em Plugins, Adicionar novo, Enviar plugin e suba o arquivo .zip. Ative e cole a chave da licença em WPML, Registro de plugins. Sem o registro, o plugin funciona, mas não recebe atualizações de segurança, o que é risco em um site de produção. Instale também o String Translation agora, pois quase todo tema precisa dele.

### Passo 2: Defina o idioma padrão e os idiomas adicionais

No assistente, escolha o idioma atual do site como padrão (geralmente português) e marque os idiomas que vai oferecer, como inglês e espanhol. Essa escolha define a URL base, então confirme antes de avançar. Adicionar idioma depois é simples; trocar o padrão depois exige reconfigurar todas as URLs e quebra links indexados.

### Passo 3: Configure o formato de URL por idioma

Selecione "diretório diferente para cada idioma" (gera /en/, /es/), que é a opção recomendada para SEO porque mantém tudo no mesmo domínio e o hreflang funciona sem complicação. As outras opções, subdomínio e parâmetro, espalham autoridade ou criam URLs feias. Salve os permalinks em Configurações, Links permanentes para o .htaccess gravar a regra correta.

### Passo 4: Traduza páginas e posts no editor

Abra qualquer página e clique no ícone "+" da coluna de idiomas no editor. O WPML abre o Advanced Translation Editor, que mostra o texto original ao lado do campo de tradução, frase por frase. Traduza, revise e publique. Cada tradução recebe sua própria URL e fica vinculada ao original, gerando o hreflang automático.

### Passo 5: Traduza menus, widgets e textos do tema

Vá em WPML, String Translation para capturar os textos fixos do tema, como "Leia mais" e o rodapé. Em Aparência, Menus, crie ou sincronize o menu de cada idioma. Esse passo é o mais esquecido: sem ele, a página fica traduzida, mas o cabeçalho continua em português, quebrando a experiência.

### Passo 6: Adicione o seletor de idioma

Em WPML, Idiomas, configure o language switcher e posicione no menu, no rodapé ou via widget. Deixe-o visível acima da dobra, porque o visitante precisa achar o idioma dele em segundos. O detalhe de implementação está em <a href="https://full.services/como-adicionar-um-alternador-de-idioma-ao-wordpress/">como adicionar um alternador de idioma ao WordPress</a>, com as opções de bandeira e lista suspensa.

## Como validar o SEO e o cache depois de traduzir

Validar o WPML antes de publicar evita os dois erros que mais custam tráfego: hreflang quebrado e cache servindo o idioma errado. Faça três checagens rápidas. Primeiro, abra o código-fonte de uma página traduzida e confirme as tags `<link rel="alternate" hreflang="en">` apontando para a URL certa. Segundo, rode a URL em inglês no <a href="https://search.google.com/test/rich-results">teste do Google</a> para ver se ela é rastreável. Terceiro, e o mais crítico, confira o cache.

O WPML com <a href="https://full.services/glossario/cache-wordpress/">cache de página</a> sem variação por idioma faz o servidor entregar a versão em português numa URL em inglês, porque o plugin de cache guarda o HTML pela URL sem saber do idioma. A gente vê isso direto no suporte da FULL com WP Rocket mal configurado. A correção está em <a href="https://full.services/como-usar-wp-rocket-com-wpml-e-sites-multilingues/">como usar WP Rocket com WPML</a>, que mostra como separar o cache. Confirme ainda o <a href="https://full.services/glossario/slug-wordpress/">slug</a> de cada tradução, para não ficar com a palavra em português numa URL em inglês.

## Erros comuns no WPML e como evitar cada um

A maioria dos problemas de WPML vem de três causas, não de bug do plugin. A primeira é o tema com textos hardcoded no header.php, que exige varrer o String Translation. A segunda é o cache sem variação por idioma. A terceira é trocar o idioma padrão depois de indexar, o que quebra URLs já no Google.

No caso do tema, traduzir a página no editor não basta: em temas antigos é preciso registrar os textos via gettext, senão o rodapé fica em português numa página em inglês. Instalar módulos demais é outro tropeço, já que Translation Management num site pequeno só pesa no banco. Para o mapa completo, veja <a href="https://full.services/erros-comuns-ao-construir-um-site-multilingue/">erros comuns ao construir um site multilíngue</a>; e se quer rota mais leve, o <a href="https://full.services/guia-plugin-traducao-para-wordpress-translatepress/">TranslatePress</a> traduz direto na página, com menos módulos.

<aside aria-label="Metodologia dos Testes">
<h2 id="metodologia-dos-testes">Metodologia dos testes</h2>
<p>As observações deste tutorial vêm de instalações WPML acompanhadas pela base FULL entre <time datetime="2025-09">setembro de 2025</time> e <time datetime="2026-05">maio de 2026</time>, em WordPress 6.5 e 6.6 com PHP 8.2, em servidores Apache e LiteSpeed. Testamos o fluxo completo: instalação, configuração de URL por diretório, tradução de páginas, String Translation e validação de hreflang. O comportamento de cache foi reproduzido com WP Rocket e LiteSpeed Cache ativos. Os tempos citados são medianas observadas no suporte, não garantias; cada tema e stack reage de um jeito, por isso recomendamos teste por ambiente antes de publicar.</p>
</aside>

## Quando o WPML compensa e a alternativa FULL

O WPML compete por profundidade de tradução manual e controle de SEO, enquanto o Polylang compete por núcleo gratuito e leveza e o Weglot compete por tradução automática na nuvem. Para um site editorial com muito conteúdo e equipe revisando idioma, o WPML costuma valer o investimento. O custo, porém, é recorrente.

A licença CMS começa em US$39 por ano e renova sempre. Em um plano FULL PRO de R$849,90 por mês para até 10 sites, o custo por site cai para cerca de R$85, com o bundle de plugins premium já incluso. A gente vê no suporte da FULL que, para quem gerencia vários sites multilíngues, esse rateio muda a conta. Compare os <a href="https://full.services/planos">planos FULL</a> antes de comprar licença avulsa.

<ul class="arvore-decisao" style="margin-bottom:1.5rem">
<li><strong>Se você tem um site editorial grande com revisão humana</strong> → o WPML compensa pela profundidade.</li>
<li><strong>Se o orçamento é zero e o site é pequeno</strong> → comece com Polylang gratuito.</li>
<li><strong>Se você quer tradução automática sem mexer no banco</strong> → avalie Weglot na nuvem.</li>
<li><strong>Se você gerencia vários sites e quer o bundle</strong> → o plano FULL dilui o custo para R$85 por site.</li>
</ul>

<h2 id="faq">Perguntas frequentes sobre o WPML</h2>

<details>
<summary>É possível deixar o site multilíngue sem usar o WPML?</summary>
<p>Sim, dá para usar Polylang, TranslatePress ou Weglot no lugar do WPML. O Polylang tem núcleo gratuito e é leve; o TranslatePress traduz direto na página; o Weglot faz tradução automática na nuvem a partir de cerca de 15 euros por mês. O WPML se destaca quando você precisa de controle fino de SEO e tradução manual revisada, mas não é obrigatório para todo projeto.</p>
</details>

<details>
<summary>Por que a página traduzida fica com o menu em português?</summary>
<p>Isso acontece porque o menu e os textos do tema não são traduzidos junto com a página. O WPML traduz o conteúdo no editor, mas cabeçalho, rodapé e itens de menu exigem o módulo String Translation e a configuração de um menu por idioma em Aparência, Menus. Em temas com texto hardcoded no header.php, é preciso registrar as strings via gettext para o WPML capturar.</p>
</details>

<details>
<summary>Qual é o formato de URL recomendado no WPML para SEO?</summary>
<p>O formato recomendado é diretório por idioma, que gera URLs como /en/ e /es/ no mesmo domínio. Ele concentra a autoridade no domínio principal e faz o hreflang funcionar sem complicação, ao contrário de subdomínio, que divide a autoridade, ou parâmetro de URL, que cria links sujos. Configure isso no assistente e salve os permalinks logo após a escolha.</p>
</details>

<details>
<summary>Quanto custa o WPML e vale a pena no plano da FULL?</summary>
<p>A licença CMS do WPML começa em US$39 por ano por site e renova anualmente. No plano FULL PRO de R$849,90 por mês para até 10 sites, o custo por site fica em torno de R$85, com vários plugins premium já inclusos no bundle. Para quem mantém um único site simples, a licença avulsa basta; para quem gerencia vários sites, o bundle dilui o custo.</p>
</details>

<details>
<summary>O que acontece com o cache quando ativo o WPML?</summary>
<p>O cache de página pode servir o idioma errado se não houver variação por idioma configurada. O plugin de cache guarda o HTML pela URL sem saber do idioma, então um visitante pode receber português numa URL em inglês. A correção é separar o cache por idioma no WP Rocket ou no LiteSpeed Cache, limpando o cache após cada tradução publicada.</p>
</details>

## Próximos passos para o seu site multilíngue

Configurar o WPML em 6 passos resolve a parte mecânica, mas o que separa um site multilíngue que ranqueia de um que só existe é a validação de hreflang, menu e cache antes de publicar. Comece pelo formato de URL por diretório, traduza páginas e textos do tema juntos e confira o cache por idioma no fim. Se você gerencia vários sites e quer o bundle premium sem licença avulsa, o plano FULL dilui o custo do WPML e dos demais plugins. Para continuar aprendendo, o FULL Academy reúne tutoriais, guias e reviews de WordPress em um só lugar.

<p class="wp-caption-text">Legenda: a tela de idiomas do WPML define a estrutura de URL que sustenta todo o SEO internacional.</p>
