ナレッジベース
公開されました May 14, 2026

Unable to Map an Object's Multiselect Picklist Field in a Form

written-by

Stanley Huang

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Issue

When creating a Liferay Form that stores data in a custom Object, you cannot map an Object's "Multiselect Picklist" field to a "Multiple Selection" field on the form canvas. The multiselect object field does not appear in the Object Field dropdown under the Advanced tab of the Multiple Selection form element.

Environment

DXP 2025.Q1.5

Resolution

This is the expected behavior. In DXP, an Object's "Picklist" field (including multiselect) is only compatible with the Select from List form field.

Follow these steps to correctly map the field and allow multiple choices:

  1. In the form builder, add a Select from List field to the canvas.
  2. In the settings for this field, enable the Allow Multiple Selections toggle. This transforms the dropdown into a multi-select component.
  3. Navigate to the Advanced tab for this field.
  4. From the Object Field dropdown, select and map your multiselect picklist field from the Object.

Why does it work this way?

This behavior is dictated by Liferay's Field Compatibility Reference:

  • Picklists: Picklists are structured as predefined system choices backed by the ListType framework. The Select from List form component is the only element engineered to pull and store data from these predefined list structures.
  • Multiple Selection: The Multiple Selection checkbox form field is designed to handle raw Text String data. Because a Picklist is not a simple string field, the system excludes it from the mapping options for the Multiple Selection component to maintain data integrity.

Additional Information

did-this-article-resolve-your-issue

ナレッジベース