Static List

Last modified by Simon Urli on 2021/04/19

Static List allows to store and display single-select or multi-select fields that can be displayed as select, checkbox, radio or suggests fields.


We list in the following the properties of Static List and their meanings.

Display Type

Several types are available for displaying a static list:

  • select: display the list as an html select
  • checkbox: display the list as checkboxes
  • radio: display the list as a radio button
  • input: display a simple input text. Note that this option might be used in combination with Use suggest and Free text, to allow entering custom values.

Multiple select

If checked, it allows to select multiple values. Else it only allow to select one value.

Use suggest

This property only works in combination with input display type: it allows to display a suggest list when the user is typing in the input text, and to select from it.

Allow large strings

This property has been introduced in XWiki 11.5 and allow to store values with more than 255 characters.

XWiki 13.2+ The "short" value limit has been increased to 768 characters.

Size of the corresponding form element in edit mode

This property is useful only with *select* display, it allows to specify the number of options to display in the select.

Multiselect separators (for editing)

This property allows to specify some operators used to distinguish multiple values in a single string, in edit mode.
By default, the value accepted separators are "|", "," and " ".
For example, if you send the value "Foo|Bar|Baz" in edit, it would be considered as the three values: Foo, Bar and Baz.
Note that it's possible to create empty string values, but only when using the same separator twice, so for example: Foo||Bar will be considered as the three values "Foo", "" and "Bar", while Foo, Bar will be only considered as the two values "Foo" and "Bar" even if two separators ("," and space) are used.

Join separator (for display)

This property allows to specify a string that will be used to join the values selected in the list.
For example if this property contains the value "+++", and the selected value are Foo, Bar et Baz, the produced output will be: Foo+++Bar+++Baz.


Allows to sort the options.

Free text

This option should be used in combination with an input display type.
If set to allows or discouraged, it allows user to type a custom text that is not part of the predefined values.
If set to forbidden, only the values that are specified can be used.

Relational Storage




Default Value

The value selected by default.


The list of values to propose in the Static List.
The edit separators must be used to separate the different values.
Note that if Free text is properly set, users might also be able to enter a custom value.

Get Connected