--- 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%3A32%3A24Z&se=2026-11-21T22%3A32%3A24Z&sr=b&sp=r&sig=pCvSbOp2pCPsx3PSub6e7yyiCeKEIJDmcGACmUaybHk%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%3A32%3A24Z&se=2026-11-21T22%3A32%3A24Z&sr=b&sp=r&sig=l4Mx1uwLL%2FjkWEOX9k3MwoxzpNUlQDTr7lhN3QU4ACs%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%3A32%3A24Z&se=2026-11-21T22%3A32%3A24Z&sr=b&sp=r&sig=%2BTTy7HfrdAi%2BrKIQEw%2B2TIAvg%2BiPZpefjn8UC%2FzEIEk%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%3A32%3A24Z&se=2026-11-21T22%3A32%3A24Z&sr=b&sp=r&sig=RFTP%2BuBH3UErRZtWEInYjLlVCEk8725XzdIuYUPyz4c%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%3A32%3A24Z&se=2026-11-21T22%3A32%3A24Z&sr=b&sp=r&sig=gpSNe83iyHpW4IBuuR97xM33GkAfh6wHYhu53arhUGM%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%3A32%3A24Z&se=2026-11-21T22%3A32%3A24Z&sr=b&sp=r&sig=dj7KCToIfHyB7EzweZOvf%2F7cMzi%2FVx6z6QQgNvk6DAU%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%3A32%3A24Z&se=2026-11-21T22%3A32%3A24Z&sr=b&sp=r&sig=3kg3R3PWhPOI0EYSvKjEhF2plMLw30A5ITe%2FMDWgywA%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%3A32%3A24Z&se=2026-11-21T22%3A32%3A24Z&sr=b&sp=r&sig=6Avz5aDFHnnE%2BPZO9XLoTh8DZQXp60xhCU3alSawNp4%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%3A32%3A24Z&se=2026-11-21T22%3A32%3A24Z&sr=b&sp=r&sig=I1gMOqNz0unymol3iYRtIaQQ8tUSLr%2BnvvHJdRANw6w%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.