Brightspot CMS User Guide

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 content type that you want to edit, or create a new content type. For details, see Creating an editorial content type.
  2. From the Items list, select Reference Field. A form appears.
  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 Unique if the field's selection must be different from selections entered in this field in other items. For example, an editor selects Blogger A in this field; editors cannot select Blogger A in this field when creating other items of this content type.
    3. Toggle on Search Filter to allow type-ahead searching. As an editor types characters in the field, Brightspot shows only the matching entries. This feature is useful for reference fields with many possible selections.
    4. Toggle on Required if this is a required field.

Configuration of a reference field.png
Configuration of a reference field
Reference field on a content edit form.png
Reference field on a content edit form
Previous Topic
Adding a number field
Next Topic
Adding a region field
Was this topic helpful?
Thanks for your feedback.