# CMS: usar campos de referência para exibir dados de várias coleções

Source: https://support.wix.com/pt/article/cms-usar-campos-de-refer%C3%AAncia-para-exibir-dados-de-v%C3%A1rias-cole%C3%A7%C3%B5es (updated 2026-11-19)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Os campos de referência permitem que você associe um item de uma coleção a um item de outra coleção. Isso permite que você conecte elementos como repetidores, galerias e tabelas a campos de várias coleções, dentro do mesmo [conjunto de dados](https://support.wix.com/pt/article/cms-about-datasets).

  
Ao adicionar um campo de referência à sua coleção, você escolhe a qual coleção fazer referência. Em seguida, para cada item da sua coleção, você escolhe um item relacionado para associar da coleção referenciada. Como resultado, você pode exibir detalhes sobre seus itens de campos armazenados em várias coleções no mesmo repetidor, galeria ou tabela. Ao conectar os elementos, você pode escolher qualquer um dos campos compatíveis da coleção referenciada nas opções de conexão do conjunto de dados. 

  
**Benefícios de usar os campos de referência:** 

* Os campos de referência permitem que você crie facilmente páginas que usam informações de todas as suas coleções referenciadas. Isso é especialmente útil em galerias e tabelas que só podem se conectar a um conjunto de dados e em repetidores que você deseja mostrar detalhes de várias coleções.
* Os campos de referência ajudam você a evitar a duplicação dos seus dados. Eles permitem que você armazene informações uma vez e, depois, consulte-as onde quiser.
* Os campos de referência ajudam você a manter a integridade dos dados nas suas coleções. Como as coleções estão intrinsecamente conectadas umas às outras, qualquer alteração nos valores dos campos é refletida automaticamente nos dados referenciados.

> **Você precisa associar itens a vários itens de outra coleção?** Se sim, use [campos de várias referências](https://support.wix.com/pt/article/cms-creating-multi-reference-fields) em vez de campos de referência. Os campos de várias referências criam uma conexão bidirecional entre as coleções, permitindo que os itens façam referência e sejam associados a mais de um item de cada coleção.

---

## Etapa 1 | (Opcional) Altere o campo principal na coleção que você deseja referenciar

O [campo principal](https://support.wix.com/pt/article/cms-formerly-content-manager-about-your-collection-fields#primary-fields) da coleção que você deseja referenciar tem uma função importante. Depois, ao selecionar os itens que deseja fazer referência no seu campo de referência, você verá os valores do campo principal. Se necessário, você pode transformar um campo diferente no campo principal para ajudar você a ver quais itens você escolhe fazer referência.

> **Importante:** Por definição, o campo principal é usado no URL da página dinâmica de item da sua coleção. Alterar o campo principal também altera os URLs das suas páginas dinâmicas se o campo principal for usado na estrutura do slug do URL das suas páginas dinâmicas. Isso pode fazer com que os links para suas páginas dinâmicas sejam quebrados. Lembre-se disso antes de alterar seu campo principal. Saiba mais [sobre estruturas do slug do URL](https://support.wix.com/pt/article/cms-creating-unique-dynamic-page-urls).

### Para alterar o campo principal da coleção que você deseja referenciar:

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. Como alternativa, você pode clicar em **CMS** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/07/18/c6258392-fdef-4a6b-8b85-1149e3260153/ab886b0a-e79c-4664-bea2-56ac47af29cb.png) no [seu editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26), e clicar em **Suas coleções**.
2. Clique na coleção que inclui o campo que você deseja referenciar. Chamamos essa coleção "referenciada".
3. (Se o campo que você deseja referenciar não for o campo principal) Clique no título do campo que deseja referenciar e selecione **Tornar principal**.

![Captura de tela da configuração de um campo como campo principal.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/26/f3c66a98-8a5a-4957-b6f9-4357cf36407c/b4e4df8d-5c56-4eaa-bd85-e53c325ea063.png)

---

## Etapa 2 | Adicione um campo de referência à sua coleção principal

Adicione um tipo de campo de referência à coleção "principal" na qual você deseja fazer referência a outra coleção. Depois, ao selecionar campos para conectar no seu conjunto de dados, os campos da coleção referenciada aparecem abaixo do nome do campo de referência, seguidos pelo nome da coleção entre parênteses: **{Nome do campo de referência} {Nome da coleção}**

### Para adicionar um campo de referência à sua coleção principal:

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. Como alternativa, você pode clicar em **CMS** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/07/18/c6258392-fdef-4a6b-8b85-1149e3260153/ab886b0a-e79c-4664-bea2-56ac47af29cb.png) no [seu editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26), e clicar em **Suas coleções**.
2. Selecione a coleção principal onde você deseja referenciar o campo principal da sua coleção referenciada.
3. Adicione um campo de referência à sua coleção:  
   1. Clique em **Gerenciar campos**.  
   2. Clique em **+ Adicionar campo**.  
   3. Selecione o tipo de campo **Referência** e clique em **Escolher tipo de campo**.  
   4. Insira o **Nome do campo**.  
   5. (Apenas para Velo) Edite o **ID do campo** usado no código do seu site, que não pode ser alterado depois.  
   6. Clique no dropdown **Coleção de referência** e selecione sua coleção referenciada.  
   7. (Opcional) Insira um **Texto de ajuda** que aparece em um tooltip na parte superior da sua coleção.  
   8. Clique em **Salvar**.

![Captura de tela da adição de um campo de referência na coleção principal.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/26/f17304f6-5880-4c87-9d41-8925c53461df/bd48ab4a-e698-4ddf-a100-091a89c5be28.png)

1. Selecione uma referência para cada item da sua coleção:  
   1. Clique no campo de referência do primeiro item da sua coleção.  
   2. Selecione o campo principal da sua coleção referenciada que corresponde ao item.  
   **Dica:** use o teclado para buscar os campos que deseja selecionar. Você também pode clicar em **Abrir coleção** para ver a coleção referenciada.  
   3. Repita esses passos para cada item da sua coleção.

![Captura de tela da seleção de itens correspondentes no campo de referência.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/27/6113b642-e904-4f08-ae79-d10fd566b5ef/6af95238-c9d7-485d-a696-777e711f572f.png)

---

## Etapa 3 | Conecte elementos aos campos de coleção referenciados

Conecte elementos como repetidores, galerias e tabelas aos campos de coleção relevantes para exibir os valores do campo no seu site. Ao escolher quais campos de coleção conectar no conjunto de dados, você verá os campos da coleção referenciada com recuo abaixo do nome do campo de referência.

### Para conectar elementos aos campos de coleção referenciados:

**Editor Wix:**

1. [Vá para o seu editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Clique no elemento que você deseja conectar ao CMS (por exemplo: repetidor, galeria, tabela).
3. Clique no ícone **Conectar ao CMS** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png).
4. (Apenas para alguns elementos de entrada) Escolha como deseja usar o elemento:  
   * **Filtrar conteúdo:** [permita que os visitantes do site filtrem o conteúdo da página](https://support.wix.com/pt/article/cms-formerly-content-manager-setting-up-filters-for-site-visitors-using-input-elements).  
   * **Coletar conteúdo:** [colete conteúdo enviado pelos visitantes do site](https://support.wix.com/pt/article/cms-creating-a-custom-form-with-input-elements-that-submit-to-your-collection).
5. Clique no dropdown **Escolha um novo conjunto de dados** e selecione um conjunto de dados que se conecte à sua coleção principal. Se preferir, clique em **Adicionar conjunto de dados**, escolha sua coleção principal, dê um nome ao conjunto de dados e clique em **Criar**.
6. Clique no dropdown relevante em **Conexões** e selecione o campo que deseja exibir no elemento. Os campos da sua coleção referenciada aparecem com recuo na lista abaixo do campo de referência.

![Captura de tela de campos sendo conectados de uma coleção referenciada.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/27/e18f402c-8031-4497-83d9-543c034c5d13/f9fa3d6b-209f-4823-8c13-1fb5ea9a1057.png)

1. Repita esses passos para cada elemento que você deseja conectar aos campos de coleção referenciados.
2. Clique em **Visualizar** no canto superior direito para testar suas conexões.
3. Clique em **Publicar** se as alterações puderem ser publicadas.

**Editor do Wix Studio:**

1. [Vá para o seu editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Clique no elemento que você deseja conectar ao CMS (por exemplo: repetidor, galeria, tabela).
3. Clique no ícone **Conectar ao CMS** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png).
4. (Apenas para alguns elementos de entrada) Escolha como deseja usar o elemento:  
   * **Filtrar conteúdo:** [permita que os visitantes do site filtrem o conteúdo da página](https://support.wix.com/pt/article/cms-formerly-content-manager-setting-up-filters-for-site-visitors-using-input-elements).  
   * **Coletar conteúdo:** [colete conteúdo enviado pelos visitantes do site](https://support.wix.com/pt/article/cms-creating-a-custom-form-with-input-elements-that-submit-to-your-collection).
5. Clique no dropdown **Escolha um novo conjunto de dados** e selecione um conjunto de dados que se conecte à sua coleção principal. Se preferir, clique em **Adicionar conjunto de dados**, escolha sua coleção principal, dê um nome ao conjunto de dados e clique em **Criar**.
6. Clique no dropdown relevante em **Conexões** e selecione o campo que deseja exibir no elemento. Os campos da sua coleção referenciada aparecem com recuo na lista abaixo do campo de referência.

![Captura de tela de campos sendo conectados de uma coleção referenciada.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/06/27/715684b4-2ecd-4e44-b86f-af85b3b262e3/973333db-5373-49cf-9b77-3b01ae14056e.png)

1. Repita esses passos para cada elemento que você deseja conectar aos campos de coleção referenciados.
2. Clique em **Visualizar** no canto superior direito para testar suas conexões.
3. Clique em **Publicar** se as alterações puderem ser publicadas.

> **Saiba mais sobre:**
>
> * [Conectar repetidores ao conteúdo da coleção do CMS](https://support.wix.com/pt/article/cms-displaying-dynamic-content-in-a-repeater).
> * [Conectar galerias ao conteúdo da coleção do CMS](https://support.wix.com/pt/article/cms-displaying-collection-content-in-a-pro-gallery).
> * [Conectar tabelas ao conteúdo da coleção do CMS](https://support.wix.com/pt/article/cms-formerly-content-manager-displaying-collection-content-in-a-table).

---

## Perguntas frequentes

Clique abaixo para obter respostas a perguntas comuns sobre campos de referência.

**Posso fazer referência a campos da mesma coleção?**

Sim. Você pode criar um campo de referência que se conecta à mesma coleção. Isso permite que você associe itens a outros itens da mesma coleção. Por exemplo, em uma coleção com informações sobre o funcionário, você pode usar um campo de referência "gerente" para associar cada item (funcionário) a outro item (gerente do funcionário).

**O que acontece se eu excluir um item de uma coleção referenciada?**

Se você excluir um item referenciado, "Sem título" aparece no campo de referência na sua coleção. Elementos que estavam conectados ao item do campo referenciado não exibirão mais o conteúdo do item excluído.

**O que acontece se eu alterar o campo principal na minha coleção referenciada?**

Alterar o campo principal em qualquer coleção pode fazer com que os links existentes para suas páginas dinâmicas sejam quebrados se o campo principal for usado na [estrutura do slug do URL](https://support.wix.com/pt/article/cms-creating-unique-dynamic-page-urls). Lembre-se disso antes de alterar qualquer campo principal.

  
Se você alterar o campo principal da sua coleção referenciada, você verá os valores do novo campo principal no campo de referência da sua coleção principal.

**Posso ver quais coleções usam os dados da minha coleção?**

Sim. No painel de controle do CMS do seu site, a coluna **Relações** mostra quantas outras coleções usam os dados de cada coleção por meio dos campos de referência. Passe o mouse sobre o número para ver as coleções que fazem referência e clique em **Abrir** para ir para uma. A coluna **Relações** fica oculta por padrão. Você pode mostrá-la no painel **Personalizar colunas**. 

Saiba mais sobre como [gerenciar suas coleções no painel de controle do CMS](https://support.wix.com/pt/article/cms-managing-your-collections-from-the-cms-dashboard).

**Posso excluir uma coleção que faz referência a outras coleções?**

Não. Você não pode excluir uma coleção enquanto outras coleções fizerem referência aos seus dados. Remova os campos de referência relevantes ou atualize-os para que apontem para uma coleção diferente e, em seguida, exclua a coleção. Saiba mais sobre como [excluir uma coleção](https://support.wix.com/pt/article/cms-formerly-content-manager-deleting-a-collection).

**O que é a estrutura do slug do URL?**

A estrutura do slug do URL define a última parte do endereço web para cada uma das suas páginas dinâmicas. Ela ajuda a descrever o conteúdo de cada página para que os visitantes do site e os motores de busca entendam do que se trata. 

  
Adicione variáveis à estrutura do slug do URL se quiser usar campos de suas coleções no URL de cada página dinâmica. 

  
Saiba como [adicionar variáveis a URLs de páginas dinâmicas](https://support.wix.com/pt/article/cms-creating-unique-dynamic-page-urls).
