Content type Model definition

A model definition, a subitem of the Magnolia Content type definition, defines the model of a content type. The model describes the properties of a content item such as name, description, asset, birthday, and so on.

In the default JCR-based implementation, the type of the properties can be String, Boolean, Decimal, Double, Long, Date, asset, richText, another content type or a submodel. The model can define a list of submodel definitions.

Model definition properties

When designing a model don’t think about it in terms of UI elements like fields. Think in terms of what type of data the field stores. For example, a link field. stores a String type (i.e., property). The property in the model definition can be decorated in the app definition with whatever UI element stores that data type.

  workspace: tourguides
  autoCreate: true

  nodeType: mt:tourGuide
    - name: birthday
      type: Date (1)
    - name: gender
    - name: shortBio
    - name: contact
      type: contactData
    - name: contactData
        - name: email
        - name: phoneNumber
        - name: addresses
          type: address
          multiple: true
    - name: address
        - name: street
        - name: city
        - name: postalCode
        - name: country
1 Here, the type set is Date.
Property Description



A list of property definition objects.


A subdefinition item defining one property of the model. Its definition interface is PropertyDefinition.

Read the Property definition properties section for all the details of a PropertyDefinition object.



A list of submodel definition objects.


A subdefinition item configuring a complete submodel. Its definition interface is SubModelDefinition.

A submodel has the same properties as a model, but a submodel cannot have additional submodels.

If nodeType is not provided, the mgnl:contentNode is used by default.



The name of the JCR node type for storing an item of the given content type.

If the given node type has not been registered yet, the system automatically registers a new node type by the given name. The type generated inherits from the Magnolia mgnl:content node type.

If nodeType is not provided, mgnl:content is used by default.

Property definition properties

This section describes the PropertyDefinition item.

Property definition items can be defined in the properties property, which is a property of the model definition of a content type definition.

Table 1. <property>
Property Description



The name of the property. The name is used for storing values in the underlying data source.


optional, default is String

Possible values:

  • JCR property types

    • String

    • Boolean

    • Decimal

    • Double

    • Long

    • Date

  • richText - creates a Rich text field, which is a custom Magnolia field implementing the CKEditor component.

  • asset - creates a Link field to choose an asset.

  • The name of a Submodel.

    You can only reference submodels defined in the same content type.
  • The name of a Content type making a reference to another content item. Prefix the value with reference: (for example, + type: reference:tourGuide)


optional, default is false

Makes the property mandatory.


optional, default is false

Enables i18n support for the property.

You also need to enable i18n for a site definition. There, use info.magnolia.cms.i18n.DefaultI18nContentSupport as the value for the class property. For example, see this configuration for the fallback site of DX Core, if no other site is present:
    'extends': 'override'
    'extends': 'override'
    'class': 'info.magnolia.cms.i18n.DefaultI18nContentSupport'
    'enabled': true
    'fallbackLocale': 'en'
        'country': ''
        'enabled': true
        'language': 'en'
        'country': ''
        'enabled': true
        'language': 'de'


optional, default is false

The true setting allows storing multiple values of the property.



Defines a parent node for a list of selectable options (OptionDefinition) rendered as a select field.

  nodeType: lib:book
    - name: category
          value: catFiction
          label: Fiction
          value: catPoetry
          label: Poetry

Options dropdown

Further customization such as using an alternative control, for example a radio button group, is possible by overriding the class or the fieldType property in the app descriptor.

Currently, the values are saved to the JCR repository only as the String type: MGNLCT-132.



Value saved to the repository when selected.



Option label displayed to the user.


Use submodels to define complex content types.

Submodels are useful whenever you need a group of fields more than once. A content type model definition can contain a list of submodel definitions within the subModels property. Submodels can be used only within the content type where they have been defined.

A submodel definition has the same properties as a model, but a submodel cannot have additional submodels.

The default nodeType for a submodels is mgnl:contentNode.

Interfaces and classes


The base interface is ModelDefinition.

Magnolia provides the JcrDataSourceDefinition interface and the ConfiguredJcrModelDefinition implementation class to specify the model to be mapped to a JCR node.

For ModelDefinition, ConfiguredJcrModelDefinition is set as the default implementation class via type mapping on the XML-based module descriptor of the magnolia-content-types module.

By default, Magnolia expects you to configure properties for JcrModelDefinition to define a model.


The submodel item is defined by the SubModelDefinition interface, which extends ModelDefinition. The default implementation is ConfiguredJcrSubModelDefinition.

By default, Magnolia expects you to configure properties for ConfiguredJcrSubModelDefinition to define a submodel.