Custom Fields

Custom fields let you add extra data fields to Unusual Suite's most important data types. They work just like regular system properties, so you don't need to learn anything new.

Create a Custom Field

Open the Configuration module and choose 'Custom fields' from the dropdown at the top left. In the selection menu in the middle, pick the data type you want to add a custom field to. Click the 'Add' icon at the top right, enter a unique name, and click 'Save' . Then configure the field's properties in the panel on the right and click 'Save' to keep your changes.

Only users with the 'Administrator' profile entitlement can configure custom fields.

Configure Custom Field Properties

Each custom field has the following properties you can set in the right-hand panel:

  • Display name — any text label shown in the UI.
  • Order — controls the position in which the field appears on screens.
  • Required / Optional — whether the field must be filled in.
  • Indexed — improves performance for column sorting and filtering.
  • Unique — enforces unique values across records.
  • Property kind — primarily affects how the field appears in the UI.

For 'Text' fields, you can define standard values. Enter each value on a separate line — for example, a field called 'Animal' might list 'dog', 'cat', and 'bird', one per line.

Choose a Data Type

Select the data type for your custom field in the left-hand panel. The available types are:

  • Bool — e.g. 'true'/'false', 'yes'/'no', 'on'/'off'
  • Datetime — e.g. '2024-12-24', '2024-07-01 15:30:00'
  • Floating point number — e.g. '123.456788', '-0.123456'
  • Integer number — e.g. '123', '0', '-987'
  • Reference — a link to another Unusual Suite data type, e.g. 'Project'
  • Text — e.g. 'Madrid', 'Dog', 'Many words form a sentence'

Use Custom Fields

Custom fields work like regular system properties — column sorting and filtering are supported in most cases. The exception is 'Reference' fields: sorting and filtering only work if the hosting data type is one of the modules found in the tab.

Custom fields aren't included in Power-Search.