Adding a reference field

A reference field enables editors to select an item existing in Brightspot. A common example of a reference field is selecting an author for an article or a blogger for a blog post.

To add a reference field:

1. Search for and open the editorial content type that you want to edit, or create a new editorial content type. For details, see Creating an editorial content type.
2. From the Items list, select Reference Field.
3. Under Main, in the Name field, enter a name for this field.
4. From the Count field, select one of the following:
   
   • One—Editor can select only one item.
   • Many—Editor can select more than one item.
   • Many (Sortable)—Editor can select more than one item, and then rearrange the selections into a desired order.
5. From the Types list, select the content types used to populate the reference field. For example, if you want editors to be able to select an author, select the Author content type.
6. (Optional) Under Advanced, do the following:
   
   1. In the Note field, enter a short explanatory note that appears in the content edit form.
   2. Toggle on Search Filter to index this field, making it usable as a query predicate. This allows you to filter results based on this field when querying through the CMS search, the GraphQL Content API (GCA), or any other API that relies on Dari queries.
   3. Toggle on Required if this is a required field.