# CMS: importar conteúdo para uma coleção

Source: https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-importar-conte%C3%BAdo-para-uma-cole%C3%A7%C3%A3o (updated 2026-11-12)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Economize tempo e esforço ao importar conteúdo para sua coleção do CMS (sistema de gerenciamento de conteúdo) de um arquivo CSV (valores separados por vírgulas). 

  
 Esse recurso pode ser particularmente útil se você já tiver todas as suas informações armazenadas em uma planilha ou se quiser [exportar](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-exportar-dados-da-coleção) seu conteúdo, fazer alterações nele em um aplicativo de planilha e, em seguida, importá-lo de volta para sua coleção.

> **Importante:** Você não pode importar um arquivo CSV diretamente para uma nova [coleção de catálogo](https://support.wix.com/pt/article/cms-vender-itens-de-coleções-do-catálogo). Para adicionar itens em massa, importe seu arquivo CSV para uma coleção de conteúdo normal primeiro e, em seguida, converta essa coleção em uma coleção de catálogo. Depois que a coleção é convertida, as importações em CSV para essa coleção de catálogo funcionam normalmente.

---

## Preparar seu arquivo CSV para upload

Ao importar para uma coleção existente, certifique-se de incluir todos os campos e valores que você quer que sua coleção tenha após a importação. Se você não mapear um campo de coleção existente para uma coluna em seu arquivo, todos os valores no campo existente serão apagados. Isso não se aplica a campos do sistema, como ID, Data de criação, Data de atualização, Proprietário ou links de páginas dinâmicas. 

  
 Você pode [exportar sua coleção existente](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-exportar-dados-da-coleção) primeiro, para garantir que os dados com os quais você deseja trabalhar e importar depois contenham todos os campos e valores relevantes.

### Prepare seu arquivo CSV de acordo com as seguintes diretrizes:

* A primeira linha do seu arquivo representa o cabeçalho. Cada coluna da primeira linha é importada como um campo em sua coleção.
* As linhas restantes são importadas como itens em sua coleção. O valor de cada célula é importado como conteúdo dentro dos campos da coleção.
* O arquivo deve usar vírgulas como separador entre os campos.
* O tamanho do arquivo não pode ser maior que 1 GB.
* O arquivo não pode ter mais de 50.000 itens. Se você precisar importar mais itens, salve-os em arquivos CSV separados e importe-os um por um.
* O arquivo não pode ter mais de 1.000 campos.

### Outros fatores a serem considerados ao preparar seu arquivo:

* O nome do seu arquivo CSV não precisa corresponder ao nome da sua coleção.
* Se a sua coleção incluir caracteres não latinos, certifique-se de que o arquivo CSV seja [codificado em UTF-8](https://developer.mozilla.org/pt-BR/docs/Glossary/UTF-8).
* Se o modo Sandbox estiver ativado, sincronizar sua coleção Sandbox com Live copiará o conteúdo para sua coleção do Live. Saiba mais sobre [como sincronizar coleções Sandbox e Live](https://support.wix.com/pt/article/cms-coleções-sandbox-e-live-e-sincronização).

### Regras e limitações de diferentes tipos de campo:

Sua coleção do CMS pode armazenar diferentes tipos de conteúdo em cada tipo de campo. O conteúdo não é validado quando você importa, portanto, certifique-se de fazer a correspondência entre o conteúdo e os tipos de campo corretos.

**ID**

Você pode atualizar itens existentes em sua coleção ao importar conteúdo de um arquivo CSV que inclui os IDs dos itens. A abordagem mais simples para garantir a precisão é incluir o campo de ID ao [exportar o conteúdo da sua coleção existente](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-exportar-dados-da-coleção).

  
![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/04/05/df534b73-7631-413f-a9bc-7641a9c99141/42934f59-8d85-4f70-a837-700b1ce52dc8.png) 

  
 Ao importar seu arquivo: 

* Se a coleção existente já tiver itens com os mesmos IDs, você pode optar por substituir os IDs ou pular a importação de itens que tenham IDs correspondentes.
* Se a coleção existente não tiver itens com os mesmos IDs, as linhas serão adicionadas como novos itens que usam os IDs listados no seu arquivo CSV.

**Campos booleanos**

Se você estiver importando conteúdo para um tipo de campo definido como booleano, precisará definir como os valores true e false são formatados em seu arquivo CSV.  
  
 No exemplo abaixo, os valores no arquivo CSV são **Sim** e **Não**. A coluna **Exemplos após a importação** mostra como eles serão importados.  
  
![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/9fece466-836a-4dbb-b473-f21bfa85fc71/2019/04/07/a4b2f2ae-df8d-4d31-bec3-9e7ec79a7d03/68532441-1665-45b9-9bc4-7408af467ea1.png)

**Campos Data e Hora**

Se você estiver importando dados para um tipo de campo definido como Data e Hora, será necessário definir como as datas são formatadas em seu arquivo CSV.

  
**Observações:** 

* Isso não afeta a forma como as datas aparecem na sua coleção.
* Saiba como [formatar datas e horários exibidos no seu site online](https://support.wix.com/pt/article/cms-formatar-o-conteúdo-de-data-e-hora-do-site-online-da-sua-coleção).

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/9fece466-836a-4dbb-b473-f21bfa85fc71/2019/04/07/f72d88d8-b138-462f-af5b-d4948ce6e68e/3e6a1855-1479-45ba-9aca-64fb6866d829.png) 

  
* Os campos de horário do arquivo CSV exportados serão exibidos como UTC+0\. Os horários que você vê nos campos de horário das suas coleções são convertidos para o fuso horário em que você está atualmente.

  
![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/f0656688-8ed1-488a-888d-62373b7c3a3c/2021/02/02/f244cef0-23ef-41ee-8da3-4b06a0d2254c/b9c02de4-46d0-47e4-b1f7-3543ba853ead.png)

**Campos de referência**

Ao importar campos de referência, os valores armazenados nos campos são os [campos do sistema de ID](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-sobre-os-campos-da-coleção#system-fields) dos itens referenciados. Saiba mais sobre como trabalhar com [campos de referência](https://support.wix.com/pt/article/adicionar-um-campo-de-referência-a-uma-coleção-do-banco-de-dados).

**Exceções**

Você pode importar qualquer tipo de campo compatível para sua coleção, exceto:

* Campos que vinculam a páginas dinâmicas.
* [Campos do sistema](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-sobre-os-campos-da-coleção#system-fields) diferentes do campo de ID.
* Campos de documento, a menos que estejam vinculados a documentos que já existem no seu gerenciador de mídia.
* Campos de imagem, a menos que estejam vinculados a imagens que já existem no seu gerenciador de mídia.

---

## Importar o conteúdo da coleção do seu arquivo CSV

Agora que seu arquivo CSV está pronto, vá para a coleção relevante para importá-lo. Para cada coluna, você pode escolher se deseja importá-la como um novo campo ou substituir um campo existente. Por definição, colunas que têm os mesmos nomes ou chaves que campos existentes em sua coleção são mapeadas juntos.

> **A importação de um arquivo CSV substitui os valores em sua coleção existente:**
>
> * Se você não mapear uma coluna para um campo existente, todos os valores no campo serão apagados quando a importação for concluída. Isso não se aplica a campos do sistema, como ID, Data de criação, Data de atualização, Proprietário ou links de páginas dinâmicas.
> * Se você desmarcar uma coluna para impedir que ela seja importada e se sua coleção tiver um campo com o mesmo nome, os valores no campo existente serão apagados a menos que você mapeie outra coluna para o campo existente. Esse comportamento não se aplica aos campos do sistema.

### Para fazer upload do seu arquivo CSV:

1. [Vá para CMS](https://www.wix.com/my-account/site-selector/?buttonText=Ir%20para%20CMS&title=Selecione%20um%20site&autoSelectOnSingleSite=true&actionUrl=https://www.wix.com/dashboard/%7B%7BmetaSiteId%7D%7D/database/) no painel de controle do seu site.
2. Clique no ícone **Mais ações** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/12/ae59c5da-fd96-4f93-b553-f177ecdaf370/ee1ef2ef-0572-4f72-9828-7ef96320285e.png) na coleção relevante e selecione **Importar itens para coleção**.  
**Observação:** se você ainda não criou uma coleção do CMS, clique em **Criar coleção**, selecione **Importar do CSV** e clique em **Próximo**.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/12/997d3e71-6972-4e33-9dbb-476325bd6ae6/ceb60bad-891d-4bb6-88b7-2bf542b14313.png)

1. Clique em **Escolha um arquivo**.
2. Selecione o arquivo CSV no seu computador e clique em **Abrir**.
3. Mapeie cada coluna importada à esquerda para campos novos ou existentes em sua coleção. Para cada coluna, escolha o que você deseja fazer:  
   1. Marque a caixa de seleção se quiser importar a coluna para um campo novo ou existente. Desmarque a caixa de seleção se você não quiser importar a coluna.  
   2. Clique no dropdown **Configurar coluna** e escolha uma opção:

**Campo existente**

A coluna e seus valores substituem um campo existente em sua coleção. 

1. Clique no dropdown **Mapa para campo da coleção** e escolha o campo existente que você deseja substituir. Você pode ver exemplos de como o conteúdo ficará à direita.  
![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/04/05/810d897e-1608-4abf-8f6b-bb9a497610a0/dd08079a-4222-4946-9e83-a5b2779bcb00.png)  
**Observação:** se você escolher um tipo de campo que não é compatível com o tipo de dado da coluna, os **Exemplos após importação** à direita são exibidos em vermelho para informar que você deve escolher outro [tipo de campo](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-conteúdo-compatível-com-os-tipos-de-campo-da-coleção).
2. (Se necessário) Defina as opções de mapeamento adicionais que variam dependendo do tipo de campo.
3. Repita esses passos para cada coluna em que você deseja substituir um campo existente.
4. Clique em **Próximo**.
5. Revise a tabela para garantir que as colunas de campo do arquivo CSV estejam mapeadas corretamente para os campos da sua coleção. Clique em **Voltar** se precisar ajustar qualquer uma das conexões.
6. Clique em **Importar** quando estiver tudo pronto para importar o arquivo para sua coleção.  
![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/04/05/5210e79c-dbe0-4c24-aa27-f0d02c3e1625/e90ba293-0873-4761-a515-fa5ed152afb3.png)

**Novo campo**

A coluna e seus valores são adicionados como um novo campo em sua coleção. 

1. Insira o **Nome do campo**.
2. Selecione o **Tipo de campo** para esse novo campo da coleção. Você pode ver exemplos de como o conteúdo ficará à direita.  
![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/04/05/55619d94-cec8-4b46-81de-26b543764dc3/d9db46a2-fecd-4369-b298-6917d1cc2410.png)  
**Observação:** se você escolher um tipo de campo que não é compatível com o tipo de dado da coluna, os **Exemplos após importação** à direita são exibidos em vermelho para informar que você deve escolher outro [tipo de campo](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-conteúdo-compatível-com-os-tipos-de-campo-da-coleção).
3. Repita esses passos para cada coluna que você deseja importar como um novo campo da coleção.
4. Clique em **Próximo**.
5. Revise a tabela para garantir que as colunas de campo do arquivo CSV estejam mapeadas corretamente para os campos da sua coleção. Clique em **Voltar** se precisar ajustar qualquer uma das conexões.
6. Clique em **Importar** quando estiver tudo pronto para importar o arquivo para sua coleção.  
![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/04/05/91a926ff-a137-4464-93e0-812ec89efb68/ef726de5-ca2a-4b82-b1d6-16739d37eaf6.png)

> **Cometeu um erro?** Ao importar um arquivo para sua coleção, um backup é criado em segundo plano. Esse processo não substitui o backup automático das suas coleções. Em vez disso, ele cria um backup manual que você pode usar para [restaurar sua coleção](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-fazer-backup-das-suas-coleções) para a versão pré-importação.

---

## Usar coleções Sandbox ao atualizar itens existentes

Se você estiver usando o recurso Sandbox, lembre-se de [sincronizar o conteúdo do seu Sandbox com sua coleção Live](https://support.wix.com/pt/article/cms-acessar-as-coleções-sandbox-opcional-e-live#accessing-and-syncing-sandbox-and-live-collections) após importar seu arquivo CSV.

  
 Quando o Sandbox está ativado, você pode importar conteúdo diretamente para sua coleção Sandbox no seu editor. Durante essa importação, você também pode adicionar novos campos à [estrutura da sua coleção](https://support.wix.com/pt/article/cms-sobre-a-estrutura-da-coleção). Isso significa que você pode incluir colunas no seu arquivo CSV que ainda não estão na sua coleção.
