Topics

Editorial content types


In This Guide

Brightspot comes with over one dozen content types that fit almost every electronic publication. You can also create your own editorial content types from the basic fields types, such as text and date.

Editorial content types are helpful in the following situations:

  • Creating abbreviated content edit forms that require just a few fields.
  • Re-ordering content edit forms to better match an editorial workflow.
  • Creating customized content types for specialized applications.

Creating an editorial content type

To create an editorial content type:

  1. Click menu > Admin > Content Types.
  2. In the Content Types widget, click New. A content edit form appears.
  3. From the Sites list, select the site to which this content type applies, or leave blank to apply it to all sites.
  4. In the Name field enter a name for this content type.
  5. Under Items, click add_circle_outline, and select one of the field types.
  6. Complete the form for the selected field type. (The following sections describe how to configure the available field types.)
  7. Repeat steps 4–5 to add additional fields.
  8. Rearrange the fields by dragging them into the order you want them to appear in the content edit form.
  9. Assign an icon to the content type by doing the following (if you don't assign an icon, Brightspot uses add_circle_outline):

    1. Identify the icon you want to use from the list of material icons at Icons - Google Fonts.
    2. Under Developer, in the Icon field, enter the name of the icon you selected. Use only lower-case letters, and replace any spaces with an underscore. Brightspot provides a preview of the icon, indicating you entered the icon name correctly. See the following example.

      Material icon in Google Fonts
      Original Material Icon name
      Material icon preview
      Material Icon name in Brightspot and confirmation preview
  10. Click Save.

Adding a Boolean field

Boolean fields provide a yes/no or on/off indication.

To add a Boolean 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 Boolean Field. A form appears.
  3. Under Main, in the Name field, enter a name for this field.
  4. (Optional) Under Advanced, in the Note field, enter a short explanatory note that appears in the content edit form.
Configuration of a Boolean field.png
Configuration of a Boolean field
Boolean field in content edit form.png
Boolean field in content edit form

Adding a cluster

Clusters provide accordions containing groups of fields. Editors can open and close clusters.

To add a cluster:

  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 Cluster. A form appears.
  3. Under Main, in the Name field, enter a name for the cluster.
  4. Add fields to the cluster by doing the following:

    1. Under Fields, click add_circle_outline, and select a field type.
    2. Complete the form for the field type.
    3. Repeat steps a–b to add additional fields.
Configuration of a cluster.png
Configuration of a cluster
Cluster on a content edit form.png
Cluster on a content edit form

Fields not assigned to a cluster always appear above clusters in the content edit form.

Fields not included in a cluster


Adding a tab

Tabs provide strong visual groupings of fields.

To add a tab:

  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 Tab. A Tab form appears.
  3. In the Name field, enter a name for the tab.
  4. Add fields to the tab by doing the following:
    1. Under Items, click add_circle_outline, and select a field type.
    2. Complete the form for the field type.
    3. Repeat steps a–b to add additional fields.
      Tabs in editorial content type
  5. Repeat steps 1–3 to add additional tabs.

Fields not assigned to a tab appear in the content edit form's Main tab.

Field in Main tab


Adding a row

Rows organize fields into rows and columns. This layout can reduce the screen space required for a content edit form.

To add a row:

  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 Row. A Row form appears.
  3. In the Name field, enter a name for the row.
  4. Add fields to the row by doing the following:

    1. Under Fields, click add_circle_outline, and select a field type.
    2. Complete the form for the field type.
    3. Repeat steps a–b to add additional fields.
  5. Repeat steps 2–4 to add additional rows.
Configuration of a row
Configuration of a row
Row on content edit form
Row on a content edit form

Adding a date field

Date fields provide a calendar that editors use to select a date.

To add a date 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 Date Field. A form appears.
  3. Under Main, in the Name field, enter a name for this field.
  4. (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 if this field should be indexed in search.
    3. Toggle on Required if this is a required field.
Configuration of a date field.png
Configuration of a date field
Date field on a content edit form.png
Date field on a content edit form

Adding a file field

File fields enable editors to upload images, videos, attachments, and other types of files.

To add a file 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 File Field. A form appears.
  3. Under Main, in the Name field, enter a name for this field.
  4. (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 Required if this is a required field.
Configuration of a file field.png
Configuration of a file field
File field on a content edit form.png
File field on a content edit form

Adding a location field

Location fields show a location on a map. (For information about how editors use location fields, see Specifying a location.)

To add a location 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 Location Field. A form appears.
  3. Under Main, in the Name field, enter a name for this field.
  4. (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 Required if this is a required field.
Configuration of a location field.png
Configuration of a location field
Location field on a content edit form.png
Location field on a content edit form

Adding a number field

A number field requires an editor to enter only integers (numbers without a decimal point).

To add a number 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 Number Field. A form appears.
  3. Under Main, in the Name field, enter a name for this field.
  4. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. Enter minimal and maximal values. Brightspot displays an error message in the content edit form if an editor enters a number outside of this range.
    3. Toggle on Required if this is a required field.
Configuration of a number field.png
Configuration of a number field
Number field on a content edit form.png
Number field on a content edit form

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

Adding a region field

Region fields show a region on a map.

To add a region 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 Region Field. A form appears.
  3. Under Main, in the Name field, enter a name for this field.
  4. (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 Required if this is a required field.
Configuration of a region field.png
Configuration of a region field
Region field on a content edit form.png
Region field on a content edit form

Adding a rich-text field

Editors use rich-text fields to apply formatting to text. (For information about how editors use rich-text fields, see Rich-text editor.)

To add a rich-text 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 Rich Text Field. A form appears.
  3. Under Main, in the Name field, enter a name for this field.
  4. From the Toolbar field, select one of the available toolbars.
  5. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. In the Character Count Minimum and Character Count Maximum fields, enter the minimal and maximal number of characters allowed in this field. Brightspot displays an error message in the content edit form if an editor enters text with length outside of this range.
    3. In the Suggested Minimum and Suggested Maximum fields, enter the recommended minimal and maximal number of characters for this field. Brightspot accepts the text even if it is shorter or longer than these values.
    4. Toggle on Required if this is a required field.
Configuration of a rich-text field.png
Configuration of a rich-text field
Rich-text field on a content edit form.png
Rich-text field on a content edit form

Adding a select field

A select field enables editors to select from a specific set of choices.

To add a select 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 Select 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. In the Choices field, add the choices available for this field.
  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 if this field should be indexed in search.
    3. Toggle on Required if this is a required field.
Configuration of a select field.png
Configuration of a select field
Select field on a content edit form.png
Select field on a content edit form

Adding a text field

Text fields contain plain text with no formatting.

To add a text 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 Text Field. A form appears.
  3. Under Main, in the Name field, enter a name for this field.
  4. (Optional) Under Advanced, do the following:

    1. In the Note field, enter a short explanatory note that appears in the content edit form.
    2. In the Character Count Minimum and Character Count Maximum fields, enter the minimal and maximal number of characters allowed in this field. Brightspot displays an error message in the content edit form if an editor enters text with length outside of this range.
    3. In the Suggested Minimum and Suggested Maximum fields, enter the recommended minimal and maximal number of characters for this field. Brightspot accepts the text even if it is shorter or longer than these values.
    4. Toggle on Unique if the text entered must be different from text entered in this field in other items. For example, an editor entered Crystal Goblet in this field; editors cannot enter Crystal Goblet in this field when creating other items of this content type.
    5. Toggle on Search Filter to allow type-ahead searching. As an editor types characters in the field, Brightspot shows matching entries previously entered in this field.
    6. Toggle on Required if this is a required field.
Configuration of a text field.png
Configuration of a text field
Text field on a content edit form.png
Text field on a content edit form

Adding a query field

Query fields help developers design their GraphQL objects.

To add a query 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 Query Field. A Query Field form appears.
  3. Under Main, in the Name field, enter a name for the new query field.
  4. From the Types list, select one content type.
  5. (Optional) Under Advanced > Note, enter a short explanatory note that appears in the content edit form.
Custom query field
Configuration of a query field
Query field in content edit form
Query field in content edit form