Group fields

Changed in version 12.0: The newly introduced column type folder replaces the old combination of type => 'group' together with internal_type => 'folder'.

New in version 13.0: When using the group type, TYPO3 takes care of generating the according database field. A developer does not need to define this field in an extension's ext_tables.sql file.

The group element (type' => 'group') in TYPO3 makes it possible to create references from a record of one table to many records from multiple tables in the system. The foreign tables can be the table itself (thus a self-reference) or any other table. This is especially useful (compared to the "select" type) when records are scattered over the page tree and require the Element Browser to select records for adding them to the group field.

For database relations however, the group field is the right and powerful choice, especially if dealing with lots of re-usable child records, and if type='inline' is not suitable.

This type is very flexible in its display options with all its different fieldControl and fieldWizard options. A lot of them are available by default, however they must be enabled: 'disabled' => 'false'

Most common usage is to model database relations (n:1 or n:m). The property allowed is required, to define allowed relation tables.

The group field uses either the CSV format to store uids of related records or an intermediate mm table (in this case MM property is required).

You can read more on how data is structured in Stored data values chapter.