Standard Field Types documentation for the dotCMS Content Management System

All of the field types for Content contribution on a dotCMS instance are Types of Content are defined by Webmasters with customized field types to allow content contributors to create content on a dotCMS managed site. The standard field types may include:

Field Types

Display TypeData TypeDescription
TextTextSingle line text with no formatting tools available to content contributors
TextareaTextMulti-line text with no formatting tools available to content contributors
WYSIWYGTextMulti-line text which can be easily formatted by content contributors
RadioSelection (Single)Allows selection of a single value from a set of pre-defined text values
SelectSelection (Single)Allows selection of a single value from a set of pre-defined text values
CheckboxSelection (Multiple)Allows selection of zero, one, or multiple values from a set of pre-defined text values
Multi-selectSelection (Multiple)Allows selection of zero, one, or multiple values from a set of pre-defined text values
DateDate and TimeDate (only)
Date/timeDate and TimeDate and Time
TimeDate and TimeTime (only)
Site or FolderLocationEnables each individual content item to be located in (and to inherit permissions from) a separate site or folder
BinaryFileFile or image embedded in, and accesible only to, the content it is added to
ImageFileLink to an image which can be accessed separately from the content (via the Site Browser)
FileFileLink to a file which can be accessed separately from the content (via the Site Browser)
CategoryTaxonomyAllows content contributors to select from a pre-defined list of Categories
TagTaxonomyAllows content contributors to add free-form Tags
Relationships FieldTaxonomyAllows content contributors to relate individual content items of different Content Types
Key/Value FieldTaxonomy 
Constant FieldNot DisplayedValue which is the same for all content of this Content Type
Hidden FieldNot DisplayedValue which can be changed per content item, but is not displayed on the content editing screen
CustomCustom CodeCustom field displayed and managed with Velocity and Javascript code

Organizing Fields on the Screen

The fields in the content editing screen may be arranged to make it easy for content contributors to view and edit appropriate fields.

Organization TypeAvailable ViaDescription
RowAdd Row button (bottom)Creates a separate row, in which fields may be added and arranged
TabAdd Row button (bottom)Places all rows following the Tab into a separate tab within the content editor
ColumnField List (right)Adds a column to a row, allowing you to separate fields into multiple columns
Line DividerField List (right)Adds a visible line, allowing you to visually separate fields
Permissions FieldField List (right)Removes the “Permissions” tab, displaying permissions as a field instead
Relationships LegacyField List (right)If the Content Type has any Legacy Relationships, removes the “Relationship” tab, displaying the Legacy Relationships as a field instead

Notes on Specific Field Types

Select Fields

When adding a simple “Select” list field, the first item in the list will become the default choice in the select list when the content contributor is adding content. To force the content contributor to make a conscious choice of an item in the select list do both of the following:

  • Add only a pipe (|) as the first choice in the select list (no label, no value)
  • Make the field required, so that the default first “null” choice is not valid, forcing the content contributor to click and choose an item from the select list

Multi-Select Fields

Multi-select fields do NOT need any special handling. Multi-select fields always force the contributor to choose a value, otherwise the field is left blank.

Examples

The following images display a number of the Standard Fields Types, as they're seen from a content contributor's perspective (on the Content editing screen):