# Adding a Reference Field to a CMS Collection

Source: https://support.wix.com/en/article/adding-a-reference-field-to-a-cms-collection (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

Reference fields in your CMS (Content Management System) allow you to associate an item in one collection with an item in another collection. This means you can link elements such as repeaters, galleries, and tables to fields from multiple collections, within the same dataset. They help create efficient pages, avoid data duplication, and maintain data integrity across collections.

**What are Reference Fields?**

Reference fields in the CMS enable an item in one collection to be associated with an item in another collection. They allow you to link elements like repeaters, galleries, and tables to fields from multiple collections within a single dataset. Learn how to [set up reference fields](https://support.wix.com/en/article/cms-using-reference-fields-to-display-content-from-multiple-collections).

**How do I add a reference field to my collection?**

To add a reference field, go to CMS in your site's dashboard, select your main collection, click **Manage Fields**, then **+ Add Field**. Choose the Reference field type, enter the field name, and select your referenced collection. View a full tutorial on [setting up reference fields](https://support.wix.com/en/article/cms-using-reference-fields-to-display-content-from-multiple-collections).

**How do I change the primary field in the collection I want to reference?**

Go to CMS in your site's dashboard, click your referenced collection, then click the title of the field you want to reference and select **Make primary**. 

  
**Important:** Changing the primary field will also change your [dynamic page URLs](https://support.wix.com/en/article/cms-creating-unique-dynamic-page-urls) if the primary field is used in the URL slug structure of your dynamic pages.

**How do I connect elements to my referenced collection fields?**

In your editor, click the element you want to connect to the CMS, click the **Connect to CMS** icon ![](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), select a dataset that connects to your main collection, and select the field you want to display in the element. Fields from your referenced collection appear indented in the list under your reference field. Learn how to [connect elements to fields from referenced collections](https://support.wix.com/en/article/cms-using-reference-fields-to-display-content-from-multiple-collections#step-3-connect-elements-to-your-referenced-collection-fields).

**How do I see which collections reference my collection?**

On the CMS page in your site's dashboard, the **Relations** column shows how many other collections use each collection's data through reference fields. Hover over the number to see the referencing collections, then click **Open** to go to one. 

Learn more about [managing your collections from the CMS dashboard](https://support.wix.com/en/article/cms-managing-your-collections-from-the-cms-dashboard).

**What are the advantages of using Reference Fields?**

Reference fields allow you to create pages that use info from all your referenced collections, avoid duplicating your data, and maintain data integrity across your collections. Any change in the field values is automatically reflected in the referenced data.

**What if I need to associate items with multiple items from another collection?**

In this case, use [multi-reference fields](https://support.wix.com/en/article/cms-creating-multi-reference-fields) instead of reference fields. Multi-reference fields create a two-way connection between the collections, allowing items to reference and be associated with more than one item from each collection.
