# CMS: sobre os campos da coleção

Source: https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-sobre-os-campos-da-cole%C3%A7%C3%A3o (updated 2026-11-10)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Os campos da coleção do seu CMS (sistema de gerenciamento de conteúdo) armazenam conteúdo sobre cada item da sua coleção. O tipo de campo determina o tipo de conteúdo que você pode armazenar no campo, e quais elementos do seu site podem se conectar ao campo.

  
 No layout Tabela da coleção, os campos aparecem como colunas verticais, com o nome do campo na parte superior e o conteúdo de cada item armazenado nas células. Você também pode escolher o layout Lista ou Galeria para gerenciar seus campos da coleção.

![Captura de tela dos campos da coleção do CMS sendo gerenciados.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/9df66c90-da63-4fd1-ad63-c30a478b62e2/06e482b1-623b-4ea6-873d-3a3b3ceaf28d.png)

---

## Campos principais

Cada coleção deve ter um campo Principal, indicado por um ícone de **Bandeira** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/0d290cd0-aacb-45a5-b368-8ca1671d416f/87ed1662-8a50-4dab-b13d-1bbce8681d94.png) ao lado do nome do campo. Por definição, cada coleção inclui um campo primário chamado "Título". Certifique-se de que cada item tenha um valor único no campo principal.

  
 Os campos primários são muito importantes porque são usados no [URL da página dinâmica de item](https://support.wix.com/pt/article/cms-criar-urls-exclusivos-de-página-dinâmica). Certifique-se de adicionar conteúdo exclusivo ao campo Principal para cada item que você deseja que tenha uma página dinâmica de item. Sem conteúdo no campo Principal, um URL de página dinâmica de item não pode ser criado para o item. Na coleção, você pode ver como o campo Principal é adicionado ao campo Link da página associado à sua página dinâmica de item.

![Captura de tela mostrando o campo principal e o campo Link da página para uma página dinâmica de item.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/caaa4ea3-edb3-4627-b217-9c08bae8b98a/f37b92dd-ec1d-4000-9111-6cd0f64533f1.png)

Os campos principais também são importantes para [campos de referência](https://support.wix.com/pt/article/cms-usar-campos-de-referência-para-exibir-dados-de-várias-coleções). Ao criar um campo de referência, você seleciona entre os valores no campo Principal da coleção referenciada. Se você alterar o campo Principal na coleção referenciada, os valores exibidos no campo de referência serão alterados para corresponder aos valores no novo campo Principal.

---

## Campos comuns

Você pode escolher entre vários tipos de campo ao adicionar campos às suas coleções. Cada campo consiste em um tipo de campo, nome do campo, ID do campo, texto de ajuda opcional e a capacidade de criptografar o conteúdo do campo como Informações de identificação pessoal (PII). 

  
 Além disso, você pode [definir validações de campo](https://support.wix.com/pt/article/cms-definir-validações-de-campo-nas-coleções) para tornar determinados campos obrigatórios, definir limites de contagem de caracteres, aceitar valores específicos nos campos e muito mais. Para evitar campos vazios quando você adiciona novos itens, você pode [adicionar valores padrão](https://support.wix.com/pt/article/cms-adicionar-valores-padrão-aos-campos-em-suas-coleções) que preenchem automaticamente os campos.

## Tipo de campo

O tipo de campo determina [que tipo de conteúdo você pode salvar](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-conteúdo-compatível-com-os-tipos-de-campo-da-coleção) no campo e [quais elementos do site podem se conectar ao campo](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-elementos-e-os-campos-da-coleção-aos-quais-eles-podem-se-conectar). Por exemplo, o tipo de campo multidocumento só pode salvar arquivos de documento e se conecta ao [elemento de entrada](https://support.wix.com/pt/article/cms-sobre-elementos-de-entrada-do-usuário) Botão de upload que permite que os visitantes façam upload de arquivos na sua coleção. 

  
 Você pode [alterar o tipo de campo de um campo existente](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-alterar-o-tipo-de-campo-em-uma-coleção) para ajustar o tipo de conteúdo que ele armazena. Lembre-se de que alterar o tipo de campo pode ter efeitos negativos, como links quebrados, se o campo estiver vinculado no seu site. Além disso, você não pode alterar o tipo de campo para [campos "Principal"](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-sobre-os-campos-da-coleção#primary-fields), [campos "Sistema"](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-sobre-os-campos-da-coleção#system-fields) ou para campos em [coleções que são adicionadas ao Gerenciador de Tradução no Wix Multilíngue](https://support.wix.com/pt/article/wix-multilingual-traduzir-o-conteúdo-das-coleções-do-cms).

**Que conteúdo posso armazenar em cada tipo de campo?**

O tipo de campo que você escolher determina que tipo de conteúdo que você pode armazenar no campo. Escolha entre os seguintes tipos de campo do CMS:

  
* **Essencial:**  
   * **Texto:** armazena texto simples para usar com títulos, descrições e outros conteúdos baseados em texto.  
   * **Rich text:** cria e gerencia texto usando opções de formatação, diretamente no seu CMS.  
   * **Rich content:** cria e gerencia conteúdo com formatação rich text, inserções de mídia e outros recursos avançados diretamente no seu CMS.  
   * **URL:** armazena endereços web para uso na criação de hiperlinks e links de navegação. Você pode usar apenas os seguintes formatos: **http://**, **https://**, **ftp://**, **mailto:**, **sms:**, **tel:**  
    **Observação:** os endereços web devem estar no formato **http://**ou **https://**. Entradas que começam com **www.**  são convertidas automaticamente para **http://**.  
   * **Email:** armazena endereços de email. Esse campo garante que o endereço esteja em um formato válido para que os links funcionem corretamente. Você pode conectá-lo a botões para permitir que os visitantes enviem emails com um clique.  
   * **Número:** armazena dados numéricos para diversos fins (por exemplo: quantidade, preço, dimensões).  
   * **Booleano:** armazene valores numéricos "true" ou "false" que aparecem como caixas de seleção nos campos da coleção.  
   * **Cor:** salve os números HEX que representam cores. Você pode usar as cores em elementos de texto, botões e backgrounds de seção conectados.
* **Organização e referência:**  
   * **Referência:** cria uma relação entre itens de conteúdo ao fazer referência a outro item de conteúdo.  
   * **Múltiplas referências:** crie muitas relações entre itens de conteúdo ao fazer referência a vários outros itens de conteúdo. Essas referências também podem ser vinculadas a várias fontes.  
   * **Tags:** gerencie e categorize itens de conteúdo usando palavras-chave ou etiquetas descritivas.  
   * **Categoria:** atribua itens a categorias para organizar e filtrar conteúdo. As categorias são gerenciadas em coleções de categoria e criam conexões bidirecionais automáticas. Quando você adiciona um campo "Categoria", o Wix cria automaticamente um campo "Itens atribuídos" na coleção da categoria conectada e um campo "Categoria principal" oculto na sua coleção de itens. Saiba mais sobre [como usar coleções de categorias](https://support.wix.com/pt/article/cms-usar-coleções-de-categorias-para-organizar-seu-conteúdo).
* **Mídia:**  
   * **Imagem:** armazene arquivos de imagem como arquivos do tipo JPG, PNG e GIF.  
   **Dica:** você pode adicionar imagens aos campos ao colar os URLs da imagem nos campos.  
   * **Galeria de mídia:** armazena várias imagens ou vídeos em cada campo.  
   * **Vídeo:** armazene arquivos de vídeo únicos para cada item usando tipos de arquivo como AVI, MPEG, MOV e mais.  
   * **Áudio:** armazene arquivos de áudio únicos para cada item usando tipos de arquivo como MP3, WAV, FLAC e mais.  
   * **Documento:** armazene arquivos de documentos únicos para cada item, como PDFs, CSVs e muito mais.  
   **Dica:** você pode adicionar documentos aos campos ao colar os URLs dos documentos nos campos.  
   * **Vários documentos:** armazene vários arquivos de documentos para cada item. Você também pode adicionar vários documentos aos campos ao colar seus URLs nos campos.  
   * **Recurso digital:** armazene um arquivo protegido em um item para entrega aos clientes após a compra. Disponível apenas em [coleções de catálogo](https://support.wix.com/pt/article/cms-vender-itens-de-coleções-do-catálogo), onde pode ser mapeado como o arquivo digital para venda. Saiba mais sobre o [tipo de campo "Recurso digital"](https://support.wix.com/pt/article/cms-adicionar-o-tipo-de-campo-recurso-digital).
* **Horário e local:**  
   * **Data:** armazene valores de data associados a itens de conteúdo.  
   **Observação:** a caixa de seleção **Incluir campo com horário** foi substituída pelo tipo de campo "Data e horário". Se você ativou anteriormente **Incluir campo com horário** para um campo "Data", ele foi convertido automaticamente para "Data e horário". Nenhuma ação é necessária. Seus dados existentes foram mantidos.  
   * **Data e horário:** armazena valores de data e horário exatos associados aos itens de conteúdo.  
   * **Horário:** armazena informações de horário de itens associados, independentemente da data.  
   * **Endereço:** armazene dados estruturados para endereços físicos, como nomes de rua, cidade, estado/província, código postal (CEP) e país.
* **JavaScript (código do Velo):**  
   * **Objeto:** gerencie dados complexos e estruturados usando objetos personalizados ou estruturas de dados. Você pode usar o tipo de campo objeto para armazenar e organizar vários dados relacionados como uma única unidade.  
   * **Array:** insira e gerencie vários valores em um único campo. Você pode usar o tipo de campo array para manipular uma coleção de dados relacionados, como uma lista de opções, tags ou outros conjuntos de valores relacionados.

  
 Saiba mais sobre os [tipos de campo compatíveis e suas limitações](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-conteúdo-compatível-com-os-tipos-de-campo-da-coleção).

![Captura de tela de um campo da coleção sendo escolhido.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/06/05/9b800837-97ac-4a61-a54d-012f42762c3e/95c63fbb-6be2-41b8-82e1-35259b7543fd.png)

## Nome do campo

O nome do campo aparece na parte superior de cada coluna no layout Tabela da coleção. Você também vê o nome do campo ao conectar elementos a conjuntos de dados que se vinculam aos campos da coleção. Ao alterar o nome do campo, ele é alterado em todo o CMS e no editor sem causar nenhum efeito no seu site online.

![Captura de tela de um campo da coleção do CMS sendo editado.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/d6ec78c4-a5f5-42f5-be13-3adf201d9b84/b3c48f44-e62c-4ccd-b149-95a76a2e08a7.png)

## ID do campo (apenas para Velo by Wix)

O ID do campo é usado ao fazer referência ao campo no código usando a [Data API](https://support.wix.com/pt/article/velo-trabalhando-com-a-api-de-dados) ou a [Dataset API](http://wix.to/94BuAAs/wix-dataset.html). Por exemplo, se você quiser inserir um item usando a API de dados, use o campo ID.

```javascript
wixData.insert("CollectionName", {"fieldKey": "value"});
```

Quando você cria um novo campo, o ID do campo é criado automaticamente com base no nome do campo. Você pode editar o ID do campo ao adicionar um novo campo, mas não é possível alterá-lo depois que o campo for criado. Observe que os IDs dos campos não podem começar com **$** ou conter um ponto final ("**.**").

![Uma captura de tela do ID do campo associado a um campo da coleção.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2025/01/02/c6834caf-0646-4524-9a54-faa390080dcd/b8faed7c-324e-43b3-8853-335485351f94.png)

## Texto de ajuda (opcional)

Adicione um texto de ajuda a um campo se você quiser um tooltip em sua coleção que explique para que serve o campo. Se você salvar um texto de ajuda em um campo, um ícone aparecerá ao lado do nome do campo na sua coleção. Você pode passar o mouse sobre o ícone para visualizar o tooltip do texto de ajuda. Esse texto só aparece na sua coleção para você e colaboradores com [funções do CMS](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-criar-funções-e-permissões-personalizadas) que permitem que eles visualizem a coleção.

![Captura de tela mostrando um texto de ajuda aparecendo em uma coleção do CMS.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/0af377a3-bd3c-436c-9cf8-90f5e8283298/b9b6cace-0827-4409-8874-74ee00bf3073.png)

## Encriptar como Informações de Identificação Pessoal (PII)

Ative essa alavanca para encriptação back-end adicional de dados sensíveis, como os números de identidade e passaporte. Saiba mais sobre como [armazenar dados PII](https://support.wix.com/pt/article/cms-armazenar-dados-de-informações-de-identificação-pessoal-pii).

![Captura de tela da alavanca para criptografar o conteúdo do campo como PII.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/6e283337-c980-4e30-a0de-b22c0c9b688e/c70fb4d9-1e70-4f90-b753-6a8dd67d3cff.png)

---

## Campos do sistema

O CMS cria automaticamente campos do sistema para cada coleção usada no código de back-end. Quando você adiciona páginas dinâmicas à sua coleção, os campos Link da página para sua lista dinâmica e páginas dinâmicas de item também são criados automaticamente como campos do sistema. Os campos padrão do sistema ficam ocultos na sua coleção, mas você pode visualizá-los ao clicar em **Gerenciar campos** na sua coleção. 

  
 Veja os campos padrão do sistema na tabela abaixo:

| Nome do campo | ID do campo | Tipo de campo | Descrição |
| --- | --- | --- | --- |
| ID | \_id | Texto | Um identificador único para o item. Você pode atribuir um valor ao ID ao importar um novo conteúdo de um arquivo CSV. Caso contrário, o ID é um UUID aleatório.     Usando o Velo by Wix, você também pode atribuir um valor ao ID ao adicionar itens com a Data API.     Uma vez definido, o ID não pode ser editado. |
| Data de criação | \_createdDate | Data e Horário | A data e a hora em que o item foi adicionado à coleção. |
| Data de atualização | \_updatedDate | Data e Horário | A data e a hora em que o item foi modificado pela última vez na coleção. |
| Proprietário | \_owner | Texto | Um identificador exclusivo para o criador do item. Usado nas [permissões da coleção](https://support.wix.com/pt/article/cms-visão-geral-das-permissões-da-coleção) para determinar quem criou cada item. |

> **Observação:** Os campos de horário em um [arquivo CSV exportado](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-exportar-dados-da-coleção) estão em UTC+0\. Eles NÃO estão no horário local.

---

## Campos de categoria principal

Quando você adiciona um campo "Categoria" à sua coleção, um campo "Categoria principal" oculto é criado automaticamente. Esse campo armazena qual categoria é designada como categoria principal para itens com várias atribuições de categoria.

  
**Por que a categoria principal é importante:** a categoria principal ajuda os motores de busca a entender a estrutura do seu conteúdo. Quando um item pertence a várias categorias, a categoria principal informa aos motores de busca qual categoria melhor representa o item para fins de SEO.

  
**Como a categoria principal funciona:** 

* A primeira categoria que você atribui a um item se torna automaticamente a categoria principal.
* Você pode alterar qual categoria é principal ao clicar no ícone de **bandeira** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/04/28/0c8c278e-9c15-4ada-bb75-7ba10bda7813/e6de704f-6ed7-4a2f-a61c-2e10d3e459d9.png) ao lado de uma categoria diferente no campo "Categoria".
* Você pode mostrar o campo "Categoria principal" na sua visualização da coleção para ver qual categoria é principal para cada item. Ele mostra apenas uma categoria, mesmo que o campo "Categoria" tenha várias.
* Você não pode excluir o campo "Categoria principal" de forma independente. Ele é excluído apenas quando o campo "Categoria" conectado é excluído.

  
 Saiba mais sobre [como gerenciar categorias principais](https://support.wix.com/pt/article/cms-usar-coleções-de-categorias-para-organizar-seu-conteúdo#step-4-managing-the-primary-category).

![Captura de tela mostrando um campo de categoria principal exibido em uma coleção.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/05/14/ffa93cc8-2e20-41f1-9bbd-92051a4b2e88/d2969d08-bbd2-4c50-ae75-9826de3056cc.png)

---

## Campos Link da página

Quando você cria páginas dinâmicas, os campos Link da página são criados automaticamente na coleção como campos do sistema. Esses campos criam links para suas páginas dinâmicas de lista e para o URL exclusivo de cada item nas páginas dinâmicas de item. 

  
 O formato do campo Link da página depende do tipo de página dinâmica: 

* **Páginas dinâmicas de lista:** por definição, o URL do link da página adiciona o nome da coleção ao final do endereço web da página dinâmica de lista.
* **Página dinâmica de item:** por definição, o URL do link da página adiciona o valor do campo Principal ao final do endereço web da página dinâmica de item para cada item exclusivo.

![Captura de tela dos campos Link da página para uma página dinâmica de item e página dinâmica de lista.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/cd98d531-9052-43d6-8064-0cfc6b633ce6/95a77bd3-2cfa-45be-a351-ddd00fc42bb7.png)

> **Dica:** Vá para as configurações da página do editor para [personalizar as variáveis usadas nas páginas dinâmicas](https://support.wix.com/pt/article/cms-criar-urls-exclusivos-de-página-dinâmica). Editar os valores do URL no seu editor atualiza automaticamente os campos Link da página na sua coleção.
