Skip to main content
Skip table of contents

4.0 Add a Content Type Field

Content Types are similar to Data Feed Definitions from v3.3, which have been removed

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

👥 User Journey

Add a Content Type Field User Journey

📋 Setup

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

📘 Steps

Steps for all fields

Add a hint

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

Configure default values for Locales

Default values cannot be configured for Reference Links

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

[Optional] To enable a default value for a specific Locale, click its toggle

[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

Save your changes

To save your changes, click Save

Add a Boolean Content Type Field

Click Add new field +

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

Add a Date Time Content Type Field

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

Date and time formats can be configured by administrators

Add a Number (real) Content Type Field

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

Add a Number (integer) Content Type Field

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

Add a Media Item Content Type Field

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

Add a Rich Text Content Type Field

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

The Rich Text Editor can be configured by administrators

Add a Text Content Type Field

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

Add a Picklist Content Type Field

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

Add a Reference Link Content Type Field

Default values cannot be configured for Reference Links

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 more information about adding Content Types, see 4.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 make the field a Reference Link Collection, select the Collection checkbox

An on-screen warning is displayed – converting existing Reference Link field to a Reference Link Collection causes any existing linked Content Entries to be lost

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

Notes

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

Warnings

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

🔖 References

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.