XWiki Properties (Data Types)
Version 17.14 by superadmin on 2025/12/30 23:34
Reference
Properties define the types of data that each Object instance of a Class can have. Properties have displayers (a kind of output and input preview) that control how a Property’s value is shown when viewing and how it’s edited. When defining Class Properties it is required to select a data type from the dropdown as in the following image:

| Data Type | Description | Output Preview |
|---|---|---|
| List of Users | Allows to store and display single-select or multi-select users. The field uses a user picker as shown: | ![]() |
| Number | Allows to store and display only Numbers of type integer, long, float, double. | ![]() |
| List of Groups | Allows to store and display single-select or multi-select groups. The field uses a user picker as shown: | ![]() |
| Time Zone | Allow to display and edit Time Zones. | ![]() |
| Computed Field | Allows to create a pseudo field for which the display can be configured using a custom displayer and the value retrieved by using a script. It allows combining other fields together. For example, consider the computed field containing the following script:{{velocity}}
Name: $doc.display('name') Age: $doc.display('age')
{{/velocity}} This script automatically retrieves the values of the name and age fields from the same document and displays them together, like this: | ![]() |
| Database List | Allows to store and display single-select or multi-select fields that can be displayed as select, checkbox, radio or suggests fields. The possible values of database list fields are taken from the execution of a query on other XWiki data such as Pages or Objects. The query is typically expressed in the Hibernate Query Language (see XWiki Query Module) and it can use the Velocity script notation (as long as the XWiki class author has the required scripting permission) for including dynamic parameters such as the current page space, the current time, etc. | ![]() |
| Date | Allows to store and display date or datetime values. A date picker is used automatically for this field as shown: | ![]() |
| Database Tree | Similar to Database List, but displays the data in a hierarchical tree structure. | |
| Password | Allows to store password fields, which can be encrypted or hashed. | ![]() |
| String | Allows to store and display one line texts. | ![]() |
| Allows to store email fields that can be obfuscated at display time. | ![]() | |
| Boolean | Allows to store and display boolean values (yes/no or 1/0) which can be displayed as select or checkbox fields. | ![]() |
| Static List | Allows to store and display single-select or multi-select fields that can be displayed as select, checkbox, radio or suggests fields. The possible values of static list fields are configured in the field definition. | ![]() |
| Access Right Levels | Allows selecting one or more access rights from the list of all permission types to define access control settings. | ![]() |
| Text Area | Allows to store and display large text fields (text and wysiwyg). | ![]() |
| Page | Same as a Database List field, but made to store XWiki page names. |
More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.













