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 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 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.png
Configuration of a reference field
Reference field on a content edit form.png 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.
Our robust, flexible Design System provides hundreds of pre-built components you can use to build the presentation layer of your dreams.

Asset types
Module types
Page types
Brightspot is packaged with content types that get you up and running in a matter of days, including assets, modules and landing pages.

Content types
Landing pages
Everything you need to know when creating, managing, and administering content within Brightspot CMS.

Admin configurations
A guide for installing, supporting, extending, modifying and administering code on the Brightspot platform.

Field types
Content modeling
Rich-text elements
A guide to configuring Brightspot's library of integrations, including pre-built options and developer-configured extensions.

Google Analytics
Apple News