Site multi-idioma no HubSpot: um único tema para vários idiomas, sem dor de cabeça

Toda empresa que vende em mais de um país chega na mesma encruzilhada: como ter o site em vários idiomas sem virar um pesadelo de manutenção? A solução ingênua, manter três sites separados, um por idioma, multiplica o trabalho por três e garante que, mais cedo ou mais tarde, eles vão ficar fora de sincronia, com uma versão atualizada e as outras esquecidas.

No HubSpot Content Hub, existe um caminho muito melhor: um único tema que serve todos os idiomas. Neste guia, vou mostrar como estruturar isso, separando o texto da interface em arquivos de tradução, conectando as variações de página por idioma, configurando a troca de idioma e o hreflang, e cuidando do SEO internacional. O resultado é um site multilíngue que se mantém coerente sem triplicar o esforço.

Um tema, vários idiomas

O princípio central é não duplicar o tema por idioma. Você mantém um único tema, com toda a estrutura, os estilos e os módulos compartilhados, e separa apenas o que de fato muda entre idiomas: o texto. Os elementos visuais, o comportamento e o layout são os mesmos para todas as línguas, porque a estrutura é única.

A grande vantagem aparece na manutenção. Quando você troca uma cor, ajusta um módulo ou corrige um comportamento, a mudança vale para todos os idiomas de uma vez, porque todos compartilham a mesma base. Não existe o risco de o site em português evoluir e o site em inglês ficar para trás, porque, no fundo, eles são o mesmo site falando línguas diferentes. Essa unidade estrutural é o que torna o multilíngue sustentável.

Arquivos de tradução para a interface

O texto fixo da interface, e não o conteúdo editorial das páginas, fica em arquivos de tradução de campo. No HubSpot, cada pasta de módulo e cada pasta de tema pode ter uma pasta _locales, com uma subpasta por locale de idioma e um messages.json dentro dela guardando as traduções. Estamos falando dos rótulos de botão, dos itens de menu, das mensagens do sistema, de tudo aquilo que se repete e que precisa aparecer na língua certa. O template referencia uma chave, e o HubSpot serve o texto traduzido conforme o idioma da página.

Esse padrão evita o pior erro do multilíngue: texto chumbado direto no código em um idioma só. Quando os textos da interface vivem em arquivos de tradução organizados, adicionar um novo idioma vira uma questão de traduzir as chaves, não de reescrever templates. E corrigir uma tradução é mexer num lugar só, não caçar a palavra espalhada por dezenas de módulos. A organização das traduções é o que mantém o crescimento para novos idiomas simples. As traduções de campo de módulo também podem ser feitas pelo Design Manager, enquanto as de campo de tema não têm interface lá e são editadas direto nos arquivos .json.

Variações de página por idioma

Enquanto o texto da interface vive nos arquivos de tradução, o conteúdo editorial, os artigos, as páginas de produto, os textos de venda, usa o recurso de variações de idioma do HubSpot. Você tem uma página principal e suas traduções, ligadas entre si como o mesmo conteúdo em línguas diferentes. O HubSpot entende essa relação como um grupo de variações.

Essa conexão entre as variações é mais do que organização interna. Ela é o que permite ao HubSpot rotear o visitante para a versão certa e o que sustenta o SEO internacional, porque os buscadores precisam entender que aquelas páginas são a mesma coisa em idiomas diferentes, não conteúdo duplicado. Tratar as traduções como variações ligadas, e não como páginas soltas, é o que faz o multilíngue funcionar tanto para o usuário quanto para os buscadores.

Troca de idioma e a tag hreflang

O seletor de idioma do site deve ser inteligente: ao trocar de língua, ele leva o visitante para a versão equivalente da página em que ele está, e não joga todo mundo de volta para a home. Boa notícia: o HubSpot já reescreve os links nas páginas traduzidas para apontar para a versão no mesmo idioma, então o visitante permanece na língua dele sem você programar isso, e dá para excluir um elemento específico com a classe hs-skip-lang-url-rewrite. O que o HubSpot não adiciona por você é o controle do seletor em si: ele é um módulo que você coloca no tema, e há um exemplo pronto no boilerplate do CMS para partir dele. Quem está lendo um artigo em português e clica em inglês espera o mesmo artigo em inglês, não a página inicial. Esse cuidado preserva o contexto e a paciência do visitante.

Do lado dos buscadores, a peça-chave é a tag hreflang, e a boa notícia é que o HubSpot a gera automaticamente para todo o grupo de conteúdo multi-idioma, com o código de idioma certo. Ela declara, em cada página, qual versão serve para cada idioma e região, dizendo ao Google qual entregar para quem, para o buscador não mostrar a versão errada para o visitante errado, como a página em espanhol para alguém no Brasil. Como o HubSpot também adiciona cada variação ao sitemap XML e marca as alternativas, o seu trabalho é menos escrever essas tags e mais manter as variações bem ligadas, para a automação ter as relações certas para descrever. Uma ressalva para quem desenvolve: o HubSpot declara o idioma da página no head automaticamente nos templates de drag-and-drop, mas nos templates codificados você mesmo define isso, populando o atributo lang via HubL.

Boas práticas de SEO internacional

Um site multilíngue bem feito segue um conjunto de boas práticas que, juntas, garantem que cada versão seja encontrada e bem ranqueada na sua região. Elas são poucas e diretas, mas fazem toda a diferença no resultado internacional.

• URLs claras por idioma, com um prefixo ou subdomínio consistente que sinalize a língua.
• A tag hreflang em todas as versões, cada uma apontando para as outras, fechando o circuito.
• Traduções reais, feitas ou revisadas por gente, não saída automática sem revisão, para o conteúdo não soar artificial.
• Um seletor de idioma que preserva a página atual, mudando só a língua, e nunca joga o visitante na home.

Por que isso importa para a sua operação

Para uma empresa que vende em vários mercados, o site multilíngue é a porta de entrada de cada um deles. Um site que fala bem a língua de cada região, com tradução de qualidade e a versão certa entregue a cada visitante, transmite respeito pelo mercado local e converte muito mais do que uma versão única em inglês para todo mundo. A estrutura multilíngue bem feita é o que torna a expansão internacional viável de verdade no digital.

E fazer isso com um único tema, em vez de sites separados, é o que torna a operação sustentável. O time mantém um site, não três, e cada melhoria vale para todos os mercados de uma vez. A diferença entre uma estrutura multilíngue bem desenhada e uma improvisada é a diferença entre escalar para novos países com facilidade e afogar o time em manutenção a cada idioma adicionado.

Na prática: os três sites que viviam fora de sincronia

Uma empresa que atuava em três países mantinha três sites separados, um por idioma, cada um com a sua própria estrutura. Toda mudança precisava ser feita três vezes, e na prática quase nunca era: uma versão recebia a novidade e as outras ficavam para trás. Com o tempo, os três sites tinham caras diferentes, conteúdos desencontrados e níveis de atualização distintos, transmitindo desorganização.

A consolidação num único tema multilíngue, com arquivos de tradução para a interface e variações de página ligadas para o conteúdo, resolveu a raiz do problema. Passou a existir um site só, em três idiomas, sempre em sincronia. Uma mudança valia para todos os mercados ao mesmo tempo, e o esforço de manutenção caiu a um terço. O que era um peso triplicado virou uma operação única e coerente.

Checklist do site multilíngue

1. Existe um único tema servindo todos os idiomas, em vez de sites separados?
2. O texto da interface vive em arquivos de tradução, um por idioma?
3. O conteúdo editorial usa variações de idioma ligadas entre si?
4. O seletor de idioma leva para a versão equivalente da página atual, não para a home?
5. A tag hreflang está em todas as versões, apontando umas para as outras?
6. As traduções são reais e revisadas, não saída automática sem revisão?

Perguntas frequentes

Preciso de um tema por idioma?

Não. O ideal é um único tema que serve todos os idiomas, com o texto da interface em arquivos de tradução. Assim a manutenção é única e a estrutura fica sempre consistente entre as línguas.

Como o Google sabe qual versão mostrar?

Pela tag hreflang, que o HubSpot adiciona automaticamente para todo o grupo multi-idioma, declarando o idioma e a região de cada versão. Você não a escreve à mão; basta manter as variações de página ligadas para o HubSpot gerá-la corretamente.

O seletor de idioma deve levar para a home?

Não. Ele deve levar para a versão equivalente da página atual em outro idioma, preservando o contexto. Quem lê um artigo e troca de língua espera o mesmo artigo, não a página inicial.

Onde fica o texto traduzido da interface?

Em arquivos de tradução de campo: uma pasta _locales dentro de cada módulo ou tema, com um messages.json por locale de idioma, guardando os rótulos de botão, itens de menu e mensagens. O template referencia uma chave e o HubSpot serve o texto na língua da página.

Posso usar tradução automática no site?

Pode, mas reveja sempre. Tradução automática sem revisão soa artificial, mina a confiança na marca e pode prejudicar o ranqueamento. É melhor traduzir bem menos páginas do que traduzir tudo de forma robótica.

Como o HubSpot trata as páginas em vários idiomas?

Pelo recurso de variações de idioma: uma página principal e suas traduções ligadas como o mesmo conteúdo em línguas diferentes. Essa relação ajuda no roteamento do visitante e no SEO internacional.

Vende em mais de um país e quer um site multi-idioma sustentável no HubSpot? Na Insight Sales montamos temas multilíngues com SEO internacional e tradução de qualidade. Fale com a gente e descubra como podemos ajudar.