Warning: You are browsing the documentation from version 4 to 10 of Pimcore. Please visit https://pimcore.com/docs/platform/ for the latest versions of Pimcore.

Select Datatypes

There are 7 different select widgets available. Except the Multiselect widgets, all of them are portrayed by an input field with a drop-down list of options. The database column type is VARCHAR for all select data types, TEXT for all multiselection types. The configured value (not the display value!) is stored in the database. In the case of multiselect, values are stored as a comma separated list.

Select Field

For select and multiselect the options can be defined with a value and display value in the class definition:

Select Field

Country and language have fixed option values. For the language field the options can be limited to available system languages. The country and language select field are also available as multi select fields. The user field has fixed values as well. It allows to select a user from all available Pimcore system users. Thereby a system user can be associated an object.

For multiselect types there is extra configuration to set render type (list or tags)

Select Field

Object Editor view for List Render Type:

Select Field

Object Editor view for Tags Render Type:

Select Field

Working with select data types via API

In order to set a select field's value programmatically, the value is simply passed to the setter. To set the values of a multiselect field, an array of values is passed to the setter.


If one needs to find out what options are available for a select field. This can be done by getting the field definition as follows:

$fd = $object->getClass()->getFieldDefinition("multiselect");
$options = $fd->getOptions();

If one needs to find out what options are available for a select field inside an ObjectBrick. This can also be done by getting the field definition of the brick as follows:

$fd = $brick->getDefinition()->getFieldDefinition("multiselect");
$options = $fd->getOptions();

The display name values can be obtained as follows:

$o = DataObject::getById(49);
$values = DataObject\Service::getOptionsForMultiSelectField($o, "multiselect"); // for a multiselect data field
$values1 = DataObject\Service::getOptionsForSelectField($o, "select"); // for a select data field