5.0 Add a Content Type Field

Users must be granted the Content developer permission by an administrator to access Content Types.

Select a Task

In the side menu, click Library

In the sub-menu that appears, click Content types

In the header bar, click the expander arrow if the filter options are hidden

Click Add new content type or edit an existing Content Type

If you created a new Content Type, enter a Name for it

[Optional] To display a hint to content editors filling out the field, enter a Hint

[Optional] To configure default values for Locales, click Configure

[Optional] To enable a default value for a specific Locale, click its toggle on the Default values tab

[Optional] Fill out default values for the enabled Locales

• This will initialise values for those Locales in any new Content Entries that content editors create

• The Locales here are displayed in hierarchical structure according to their fallback relationships

• You don’t need to set a default value for each Locale if fallbacks are set, since the Locale values in Content Entries are also initialised based on their fallbacks, from the top down

[Optional] To configure required field for Locales, click Configure

[Optional] To enable a required field for a specific Locale, click its toggle on the Required locales tab

To save your changes, click Save

Click Boolean

For Name, enter a name for the field

[Optional] To set default boolean values for your Locales:

1. Click Configure defaults

2. To enable a default value for a Locale, click its toggle

3. For each enabled Locale, select a default boolean value – True or False

4. When finished setting default values, click Ok

Click Add new field +

Click Date Time

For Name, enter a name for the field

[Optional] To set default Date Time values for your Locales:

1. Click Configure defaults

2. To enable a default value for a Locale, click its toggle

3. For each enabled Locale, enter a Date and a Time:

   1. For Date, enter a default date and time in one of the following ways:

      • Click the Select date icon to select a date from the calendar

      • Enter a date in the format specified – for example, DD/MM/YYYY

   2. For Time, enter a default time in the specified format – for example HH:MM

4. When finished setting default values, click Ok

Click Add new field +

Click Number (real)

For Name, enter a name for the field

[Optional] To set default Number (real) values for your Locales:

1. Click Configure defaults

2. To enable a default value for a Locale, click its toggle

3. For each enabled Locale,, enter a default value that is any real number – for example, 3.14

4. When finished setting default values, click Ok

Click Add new field +

Click Number (integer)

For Name, enter a name for the field

[Optional] To set default Number (integer) values for your Locales:

1. Click Configure defaults

2. To enable a default value for a Locale, click its toggle

3. For each enabled Locale, enter a default value that is any integer number – for example, 3

4. When finished setting default values, click Ok

Click Add new field +

Click Media item

For Name, enter a name for the field

[Optional] To set default Media Items for your Locales:

1. Click Configure defaults

2. To enable a default value for a Locale, click its toggle

3. For each enabled Locale, click Select media, then:

   1. In the Media Picker that opens, select an existing Media Item or add a new one

   2. Click Select

4. [Optional] To view the Media Item, click Preview

5. [Optional] To download the Media Item, click Download

6. When finished setting default values, click Ok

Click Add new field +

Click Rich text

For Name, enter a name for the field

[Optional] To set default Rich Text values for your Locales:

1. Click Configure defaults

2. To enable a default value for a Locale, click its toggle

3. For each enabled Locale, enter a default rich text value – for example, ‘this is rich text’

4. When finished setting default values, click Ok

[Optional] To allow content editors to mark the field for translation, select the Translatable checkbox

Click Add new field +

Click Text

For Name, enter a name for the field

[Optional] To set default Text values for your Locales:

1. Click Configure defaults

2. To enable a default value for a Locale, click its toggle

3. For each enabled Locale, enter a default text value – for example ‘this is text’

4. When finished setting default values, click Ok

[Optional] To allow content editors to mark the field for translation, select the Translatable checkbox

Click Add new field +

Click Picklist

For Name, enter a name for the field

For Picklist, select a Picklist

[Optional] To allow content editors to select multiple items, click Multi select

[Optional] To set default Picklist Items for your Locales:

1. Click Configure defaults

2. To enable a default value for a Locale, click its toggle

3. For each enabled Locale, select a default Picklist Item

4. When finished setting default values, click Ok

Click Add new field +

Click Reference link

For Name, enter a name for the field

Add a reference to another Content Type in one of the following ways:

• Link an existing Content Type – click Add existing

  • To select a Content Type from the list, click the + icon

• Create a new Content Type to link – click Create new

  • To discard the Content Type and return, on the top-right, click Discard

  • You can also return to the original Content Type by clicking on it in the Reference Links Tree

  • For the first new Content Type, you must select whether the Content type is Public or Private

For more information about adding Content Types, see 5.0 Add a Content Type

For more information about the features of the Content Type Editor, see use the Content Type Editor

[Optional] On the left-hand-side, in the Reference Links tree, click on Content Types to edit them

• You may need to first click the Expand/Collapse icon to expand the Reference Links pane

[Optional] To unlink the reference, click the Unlink icon

Click Add new field +

Click Reference link collection

For Name, enter a name for the field

Add a reference to another Content Type in one of the following ways:

• Link an existing Content Type – click Add existing

  • To select a Content Type from the list, click the + icon

• Create a new Content Type to link – click Create new

  • To discard the Content Type and return, on the top-right, click Discard

  • You can also return to the original Content Type by clicking on it in the Reference Links Tree

  • For the first new Content Type, you must select whether the Content type is Public or Private

For more information about adding Content Types, see 5.0 Add a Content Type

For more information about the features of the Content Type Editor, see use the Content Type Editor

[Optional] On the left-hand-side, in the Reference Links tree, click on Content Types to edit them

• You may need to first click the Expand/Collapse icon to expand the Reference Links pane

[Optional] To unlink the reference, click the Unlink icon

Some field types require default values to be explicitly set if enabled, while others can be enabled and left empty.

• The following field types must set default values, if enabled:

  • Boolean

  • Date Time

  • Number

  • Media Item

• However, the following field types allow empty default values (enabled but no value entered):

  • Text

  • Rich Text

  • Picklist

Enabling a default value and leaving it empty is different from disabling it. An enabled, empty default value initialises Content Entries with a Locale value, albeit an empty one, which excludes it from being populated by a fallback value.

Reference Link fields require a value – you must link a Content Type

Reference Link fields do not have default Locale values – the linked Content Type is the same in all Locales

The Name of a Content Type Field must be:

• Lowercase, uppercase, numbers, and underscores

• Between 3 and 100 characters long

• Unique per Content Type

You cannot change the selected Picklist of a Picklist field once saved – to do so, you must delete and recreate the field

You cannot link more than 10 Content Types together using Reference Links

You cannot add a Reference Link that directly or indirectly links back to itself

You cannot change the linked Content Type of a Reference Link field or mark it as a Collection once saved – to do so, you must delete and recreate the field

You can link up to 30 Content Types into Reference Link or Reference link collection

You can set a Content type to private within the parent, however this means that only one content type can be linked to that Reference link or Reference link collection field.

Content Types created inline with Create new that have not yet been saved are deleted when the parent unlinks or deletes the referencing field

1. Glossary

2. Add a Content Type