--- title: "Add a Reference Field to a Content Type" slug: "add-a-reference-field-to-a-content-type" description: "This article will show you how to add the Reference field to a Content Type. " updated: 2026-07-08T19:53:59Z published: 2026-07-08T19:53:59Z canonical: "www.civicplus.help/add-a-reference-field-to-a-content-type" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Add a Reference Field to a Content Type This article will show you how to add the **Reference** field to a **Content Type**. The Reference field type links to other content items. > [!TIP] > Who can use this feature? > > Owner | Developer | Publisher | Author (submit for review) ## Instructions [HCMS: How to Add a Refernece Field to a Content Type Practice Tutorial](https://www.iorad.com/player/1580027/HCMS--How-to-Add-a-Reference-Field-to-a-Content-Type-Practice-Tutorial) 1. [Sign in to the HCMS](/civicplus-help-center/docs/sign-in-to-the-hcms) 2. Navigate to **Content Types** on the left-hand side and select your desired **Content Type** ![Content Types section showing various types including a highlighted Department entry.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Select%20Content%20Type%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A44%3A17Z&se=2026-11-21T22%3A44%3A17Z&sr=b&sp=r&sig=CZvzDeZ2dfSCcZl7jkBoXtZ6PbveWJ4pYXl2xg6tL14%3D) 3. Click **Add Field**![List of fields with a highlighted button to add a new field.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Type,%20Add%20Field%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A44%3A17Z&se=2026-11-21T22%3A44%3A17Z&sr=b&sp=r&sig=G87F1Az3PedgkLAZOVF8GMf8%2BXUaUKgG%2BPJ8NZn7xKM%3D) 4. Select **References**![The References icon on the Add Field page.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Type,%20Field%20References%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A44%3A17Z&se=2026-11-21T22%3A44%3A17Z&sr=b&sp=r&sig=AVkf%2FZ5ZMqHBTy2rtwzhpBZm5NDrCt%2FmvEV4dUDGaSA%3D) 5. Add a **Field Name**![Input field for entering a field name in a user interface design.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Type,%20Field%20Name%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A44%3A17Z&se=2026-11-21T22%3A44%3A17Z&sr=b&sp=r&sig=Fv1NFXV%2Bliw8raeVyxg6iSyd7FFyNoPM6zS9XnGLdc0%3D) > [!WARNING] > **Note**: > > The field name can only contain letters with no spaces and cannot be changed. The display name can be edited in the Label section. 6. Select **Create and edit field**![Buttons for creating and editing fields in a user interface layout.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Type,%20Create%20and%20Edit%20Field%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A44%3A17Z&se=2026-11-21T22%3A44%3A17Z&sr=b&sp=r&sig=Ouizh4WGxVF3lvjDYC7dligLYxRhDaE896mgw3ivyTo%3D) 7. Configure **Common** fields ![Form fields for editing an address, including name, label, hints, and tags.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Type,%20Field%20Common%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A44%3A17Z&se=2026-11-21T22%3A44%3A17Z&sr=b&sp=r&sig=2xhv1UEgomjo1md%2Fh6ANRwrHlAr0kQIKzwwNImXHaog%3D) - **Name** (non-editable): Name of the field in the API response - **Label**: Define the display name for the field for documentation and user interfaces - **Hints**: Define some hints for the user and editor for the field for documentation and user interfaces - **Tags:** Add tags to annotate your field for automation processes 8. Configure **Validation** fields ![Settings for content types, validation, and item limits in a form field editor.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Type,%20Reference%20Validation%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A44%3A17Z&se=2026-11-21T22%3A44%3A17Z&sr=b&sp=r&sig=sOJLUHEvVXcvPNalUW1tvEsiBPe12geoLxfoCPnODvA%3D) - **Content Type**: Select a content type from the dropdown - **Required**: Mark to make this field required - **Allow duplicate values:** Check to allow duplicates - **Items**: Enter a **Minimum** and **Maximum** Item count 9. Configure **Editing** fields ![Editing field options including list, dropdown, tags, and checkboxes for content management.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Type,%20Reference%20Editing%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A44%3A17Z&se=2026-11-21T22%3A44%3A17Z&sr=b&sp=r&sig=sPrwbJJ8YGe0kmPg%2F47GuLl%2FIFKEf68m7PxGhdhuSSY%3D) - **Editor:** Choose **List**, **Dropdown**, **Tags**, or **Checkboxes** - **Resolve reference:** Show the name of the referenced item in the content list when MaxItems is 10. Click **Save and close** ![The Save and close button is highlighted on the content type page.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Content%20Type,%20Save%20and%20Close%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A44%3A17Z&se=2026-11-21T22%3A44%3A17Z&sr=b&sp=r&sig=wqqxLHnOTk4IpFUQBLY3uN3YutDRUrzp7BxtbCDsbvQ%3D) Application Programming Interface. A set of rules that allows programmers to develop software for a particular operating system without having to be completely familiar with that operating system.