Pular para o conteúdo Pular para a barra lateral
Início » Documentação do WPML » Projetos relacionados » WPML Export and Import » Preparando arquivos XML e CSV para importar dados multilíngues com o WPML Export and Import

Preparando arquivos XML e CSV para importar dados multilíngues com o WPML Export and Import

Kathy
Atualizado
fevereiro 26, 2026

Saiba como adicionar colunas de idioma a planilhas para importar conteúdo multilíngue para um novo site, permitindo que o WPML Export and Import atribua detalhes de idioma e conecte traduções.

Quando Você Precisa Preparar Manualmente Arquivos XML ou CSV

Se você usar plugins compatíveis para migrar conteúdo entre sites WordPress, o WPML Export and Import adicionará automaticamente os detalhes de idioma aos seus arquivos.

No entanto, há momentos em que você pode precisar criar os arquivos CSV você mesmo, por exemplo:

  • Você mantém conteúdo multilíngue em planilhas e deseja importar o conteúdo diretamente da planilha
  • Seu plugin de exportação ainda não é compatível com o WPML Export and Import, portanto o arquivo CSV ou XML que seu plugin de exportação gera não inclui automaticamente as informações de idioma

Nesses casos, você precisará adicionar manualmente as informações de idioma às suas planilhas. Você aprenderá como preparar o arquivo abaixo, mas também pode assistir ao nosso vídeo passo a passo para uma explicação visual.

Plugins necessários

Instale e ative os seguintes plugins no site para o qual você está importando:

  • Seu plugin de importação preferido
  • WPML
  • WPML String Translation
  • WPML Export and Import
  • WPML Multilingual & Multicurrency for WooCommerce (somente se você estiver importando produtos do WooCommerce)

1. Crie Planilhas com Colunas de Idioma

Dependendo da sua ferramenta de importação, você pode precisar preparar uma ou duas planilhas.

Para o WP All Import Pro e plugins de importação semelhantes, crie duas planilhas:

  • Uma para taxonomias (por exemplo, categorias, tags, categorias de produtos).
  • Outra para posts (incluindo páginas, produtos e outros tipos de post).

Para o importador CSV nativo do WooCommerce, você precisa apenas de uma planilha, com as categorias de produto incluídas nas linhas que detalham os próprios produtos.

Cada planilha deve incluir os detalhes de conteúdo usuais, juntamente com três colunas de idioma cruciais para WPML:

  • _wpml_import_translation_group: Use esta coluna para um valor exclusivo que associa o conteúdo do idioma padrão com suas traduções. Para sites de e-commerce, use o SKU do produto. Se não houver SKU, use um ID de tradução (trid). Este é um número de ID que você cria, que deve ser o mesmo para cada parte do conteúdo e suas traduções.
  • _wpml_import_language_code: Indique o código do idioma para cada item, por exemplo en para inglês, es para espanhol). Consulte os padrões ISO para idiomas personalizados (por exemplo, “es-MX” para espanhol mexicano).
  • _wpml_import_source_language_code: Use esta coluna para especificar o código de idioma original do conteúdo. Este campo é necessário apenas para traduções e você pode deixá-lo vazio para conteúdo no idioma de origem.

Aqui está um resumo das informações que sua(s) planilha(s) deve(m) conter:

Planilha de Taxonomias

ID do termo (use os IDs de termo existentes se você estiver atualizando os termos já no site)

Nome e slug

ID, nome e slug do pai (se aplicável, adicione itens pai antes dos filhos)

Planilha de tipos de post

Títulos de post/página

IDs de post/produto

Conteúdo principal e URLs de imagem em destaque

Categorias atribuídas ou categorias de produtos

Relações pai-filho (se aplicável, liste os itens pai primeiro)

*(WooCommerce apenas) Tipo de produto, atributos e preços (consulte informações sobre atributos personalizados)

*(WooCommerce apenas) ID da variação do produto e ID do produto pai

Planilha de Taxonomias

_wpml_import_translation_group

_wpml_import_language_code

_wpml_import_source_language_code

Planilha de tipos de post

_wpml_import_translation_group

_wpml_import_language_code

_wpml_import_source_language_code

Exemplo de arquivo CSV multilíngue para categorias de produtos

Exemplo de arquivo CSV multilíngue para informações do produto

Lembre-se de que IDs desempenham um papel muito importante em sua planilha:

  • Se você estiver adicionando novo conteúdo ao seu site, as colunas de ID ajudam os plugins de importação a entender as relações entre os itens. Eles identificam relações pai-filho.
  • Se você estiver atualizando o conteúdo que já existe no site, você precisa usar os IDs exatos que seus posts ou produtos têm atualmente. Isso garante atualizações precisas e evita duplicação ou erros. Para conteúdo com relações pai-filho, importe os itens pai e suas traduções primeiro, então use esses IDs na coluna ‘ID do pai’ da sua planilha.

Coluna adicional para atributos personalizados do WooCommerce

Isto é relevante quando você tem produtos variáveis com atributos personalizados do WooCommerce.

Neste caso, adicione a coluna _wpml_import_wc_local_attribute_labels. Para cada produto traduzido, adicione traduções de atributos em JSON usando pares slug:tradução.

Exemplo para um produto variável com atributos de tamanho e cor em francês: {“size”:”Taille”,”color”:”Couleur”}.

O slug é o rótulo higienizado. Basta converter o nome do atributo em letras minúsculas e substituir os espaços por traços.

2. Importe os Dados Multilíngues

Depois de salvar suas planilhas como um arquivo CSV ou XML, vá para seu novo site e configure o WPML com os idiomas que você planeja importar. Então:

  • Importe as taxonomias primeiro (se aplicável)

Ao importar categorias, tags ou quaisquer outras taxonomias primeiro, você estabelece as bases para organizar seu conteúdo no novo site.

Cada plugin de importação tem sua própria interface e etapas, e seu plugin de importação provavelmente exigirá que você corresponda ou “mapeie” os nomes das colunas de categorias do seu CSV para os campos. Esta é uma etapa crítica para permitir que o WPML Export and Import atualize corretamente as informações de idioma.

Por exemplo, se você estiver usando o WP All Import Pro:

  1. Expanda a seção Term Meta na Etapa 3.
  2. Adicione três campos de metadados de termo e arraste as colunas de idioma para os campos Valor. Use os nomes das colunas da sua planilha, sem colchetes, para os campos Nome.
Mapeando as colunas de idioma na seção Term Meta

As etapas podem variar com outros plugins, mas é muito importante mapear esses campos corretamente.

  • Em seguida, importe seus tipos de post (posts, páginas, produtos e quaisquer outros tipos de conteúdo)

Mais uma vez, você precisará corresponder ou “mapear” os nomes das colunas para dados de produtos do seu CSV para os campos.

Se você estiver usando o WP All Import Pro:

  1. Na Etapa 3 do assistente do WP All Import, role para baixo até a seção Campos personalizados.
  2. Adicione três campos personalizados e arraste e solte as colunas de idioma da barra lateral direita para os campos Valor. Para os campos Nome, use os nomes das colunas sem os colchetes. Novamente, esta etapa pode parecer diferente se você usar outro plugin de importação, mas você deve mapear esta informação para que a importação funcione.
Mapeando campos de idioma para campos personalizados no WP All Import Pro

Até você executar o WPML Export and Import, todo o conteúdo importado será agrupado em um único idioma. Se você estiver usando um plugin de importação compatível, o WPML Export and Import definirá temporariamente o conteúdo importado como Rascunho para evitar a mistura de idiomas no front-end. Para plugins não compatíveis, você precisa definir o status de publicação por conta própria.

Saiba mais sobre gerenciar a visibilidade do conteúdo importado.

3. Execute o WPML Export and Import

Com seu conteúdo multilíngue importado, acesse WPML → Export and Import e clique em Executar importação do WPML. Pode levar alguns minutos para o WPML Export and Import passar pelas etapas de adicionar as informações de idioma e conectar as traduções.

Após o WPML Export and Import concluir o processo de atualização do conteúdo importado, revise seus posts, páginas, produtos e taxonomias.

Faça esta verificação no backend e no front-end do seu site. Certifique-se de que cada item de conteúdo apareça corretamente no idioma correto e que as traduções estejam devidamente vinculadas. Se você encontrar alguma tradução de taxonomia faltando ou não conectada corretamente ao termo de idioma padrão, você precisará conectar manualmente as traduções de taxonomia.