Attention
TYPO3 v11 has reached end-of-life as of October 31th 2024 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.
Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v10 here: TYPO3 ELTS.
Group fields
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) with internal_type='db' (default). In this case property allowed is required.
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.