Support and Documentation

Custom content types
How to create a custom content type
  1. From the Navigation Menu, expand Admin, and select Content Types.

  2. In the Content Types widget, click New. A content edit form appears.

  3. In the Main field, enter a name for this content type.

  4. Under Items, click |mi-add_circle_outline|, and select one of the field types.

  5. Complete the form for the selected field type. (The following sections describe how to configure the available field types.)

  6. Repeat steps 4–5 to add additional fields.

  7. Rearrange the fields by dragging them into the order you want them to appear in the content edit form.

  8. Click Save.

Adding a Boolean field

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

Procedure. To add a Boolean field:
  1. In the Content Type form, from the Items list, select Boolean Field. A form appears.

  2. Under Main, in the Name field, enter a name for this field.

  3. (Optional) Under Advanced, in the Note field, enter a short explanatory note that appears in the content edit form.

Configuration of a Boolean field
Figure 3. Configuration of a Boolean field


Boolean field in content edit form
Figure 4. Boolean field in content edit form


Adding a cluster

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

Procedure. To add a cluster:
  1. In the Content Type form, from the Items list, select Cluster. A form appears.

  2. Under Main, in the Name field, enter a name for the cluster.

  3. Add fields to the cluster by doing the following:

    1. Under Fields, click |mi-add_circle_outline|, and select a field type.

    2. Complete the form for the field type.

    3. Repeat steps a–c to add additional fields.

Configuration of a cluster
Figure 5. Configuration of a cluster


Cluster in content edit form
Figure 6. Cluster in content edit form


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

non-clustered-fields-at-top.svg
. See also:
Adding a date field

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

Procedure. To add a date field:
  1. In the Content Type form, from the Items list, select Date Field. A form appears.

  2. Under Main, in the Name field, enter a name for this field.

  3. (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 date field
Figure 7. Configuration of a date field


Date field in content edit form
Figure 8. Date field in content edit form


Adding a file field

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

Procedure. To add a file field:
  1. In the Content Type form, from the Items list, select File Field. A form appears.

  2. Under Main, in the Name field, enter a name for this field.

  3. (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
Figure 9. Configuration of a file field


File field in content edit form
Figure 10. File field in 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.)

Procedure. To add a location field:
  1. In the Content Type form, from the Items list, select Location Field. A form appears.

  2. Under Main, in the Name field, enter a name for this field.

  3. (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
Figure 11. Configuration of a location field


Location field in content edit form
Figure 12. Location field in content edit form


Adding a number field

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

Procedure. To add a number field:
  1. In the Content Type form, from the Items list, select Number Field. A form appears.

  2. Under Main, in the Name field, enter a name for this field.

  3. (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
Figure 13. Configuration of a number field


Number field in content edit form
Figure 14. Number field in 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. (For information about how editors use reference fields, see Working with the selection field.)

Procedure. To add a reference field:
  1. In the Content Type form, from the Items list, select Reference Field. A form appears.

  2. Under Main, in the Name field, enter a name for this field.

  3. 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.

  4. 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.

  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. 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
Figure 15. Configuration of a reference field


Reference field in content edit form
Figure 16. Reference field in content edit form


Adding a region field

Region fields show a region on a map. (For information about how editors use region fields, see Working with regions.)

Procedure. To add a region field:
  1. In the Content Type form, from the Items list, select Region Field. A form appears.

  2. Under Main, in the Name field, enter a name for this field.

  3. (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
Figure 17. Configuration of a region field


Region field in content edit form
Figure 18. Region field in 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.)

Procedure. To add a rich-text field:
  1. In the Content Type form, from the Items list, select Rich Text Field. A form appears.

  2. Under Main, in the Name field, enter a name for this field.

  3. From the Toolbar field, select one of the available toolbars.

  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 Required if this is a required field.

Configuration of a rich-text field
Figure 19. Configuration of a rich-text field


Rich-text field in content edit form
Figure 20. Rich-text field in content edit form


Adding a select field

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

Procedure. To add a select field:
  1. In the Content Type form, from the Items list, select Select Field. A form appears.

  2. Under Main, in the Name field, enter a name for this field.

  3. 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.

  4. In the Choices field, add the choices available for this field.

  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. Toggle on Required if this is a required field.

Configuration of a select field
Figure 21. Configuration of a select field


Select field in content edit form
Figure 22. Select field in content edit form


Adding a tab

Tabs organize fields into smaller content edit forms within a parent content edit form.

Procedure. To add a tab:
  1. In the Content Type form, from the Items list, select Tab. A form appears.

  2. Under Main, in the Name field, enter a name for the tab.

  3. Add fields to the tab by doing the following:

    1. Under Items, click |mi-add_circle_outline|, and select a field type.

    2. Complete the form for the field type.

    3. Repeat steps a–c to add additional fields.

Configuration of a tab
Figure 23. Configuration of a tab


Tab in content edit form
Figure 24. Tab in content edit form


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

. See also:
Adding a text field

Text fields contain plain text with no formatting.

Procedure. To add a text field:
  1. In the Content Type form, from the Items list, select Text Field. A form appears.

  2. Under Main, in the Name field, enter a name for this field.

  3. (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
Figure 25. Configuration of a text field


Text field in content edit form
Figure 26. Text field in content edit form