|| - `em`_|

|| - `query_builder`_|

| Overridden| - `choices`_|

| options| - `data_class`_|

| Overridden| - `choice_name`_|

| options| - `choice_value`_|

|| - `choices`_|

|| - `data_class`_|

| Inherited| from the:doc:`choice</reference/forms/types/choice>` type:|

| options||

|| - `choice_attr`_|

|| - `choice_name`_|

|| - `choice_translation_domain`_|

|| - `choice_value`_|

|| - `expanded`_|

|| - `group_by`_|

|| - `multiple`_|

The ``choice_label`` option was introduced in Symfony 2.7. Prior to Symfony

2.7, it was called ``property`` (which has the same functionality).

**type**: ``string``or``callable``

**type**: ``string``, ``callable``or:class:``Symfony\\Component\\PropertyAccess\\PropertyPath``

This is the property that should be used for displaying the entities as text in

the HTML element::

Overridden Options

choice_name

..versionadded::2.7

The ``choice_name`` option was introduced in Symfony 2.7.

**type**: ``string``, ``callable`` or:class:`Symfony\\Component\\PropertyAccess\\PropertyPath` **default**: id

By default the name of each field is the id of the entity, if it can be get in

the class metadata by an internal id reader.

choice_value

..versionadded::2.7

The ``choice_value`` option was introduced in Symfony 2.7.

**type**: ``string``, ``callable`` or:class:`Symfony\\Component\\PropertyAccess\\PropertyPath` **default**: id

As for the ``choice_name`` option, ``choice_value`` use the id by default.

It allows an optimization in the:class:``Symfony\\Bridge\\Doctrine\\Form\\ChoiceList\\Loader\\DoctrineChoiceLoader`` which will

only load the ids passed as values while the form submission, preventing all entities,

even with a custom ``query_builder`` to be loaded.

If it can be usefull for API to use an entity property as string value, you

will gain performances by letting this option set by default.

choices

..include::/reference/forms/types/options/choice_attr.rst.inc

..include::/reference/forms/types/options/choice_name.rst.inc

..include::/reference/forms/types/options/choice_translation_domain.rst.inc

..include::/reference/forms/types/options/choice_value.rst.inc

..include::/reference/forms/types/options/expanded.rst.inc

..include::/reference/forms/types/options/group_by.rst.inc