In this section · 14 articles

Manage static fields and their options

Static fields are the fixed lists of choices that dropdowns across Laramin use. Add a field, add and order its options, and choose the option that is selected by default.

Applies to
Core 12.0 and later
Who can do this
Administrator, Platform owner
Permission
feature.core.static_option.create
Where
Configurations › Master Settings › Static Fields
On this page

Before you start

  • A static field is a named list of choices, such as a set of categories. Its options are the choices themselves. Dropdowns in Core and in modules read their choices from these lists.
  • Permissions come in two sets: feature.core.static_field.* for fields and feature.core.static_option.* for options, each with list, view, create, edit and delete.
  • The list only shows fields that belong to Core or to a module that is turned on.

Careful: Rows marked Yes in the System column come from Core or a module. You can't delete them and their Code is fixed, but you can still change the name, colour and icon. Rows marked No were added here and can be changed or deleted freely.

The Static Fields list filtered to Core and PropertyCrm, where seeded fields show Yes in the System column, the added Customer Tier field shows No, and each row has an Options button.

Add a static field

  1. Open Configurations › Master Settings › Static Fields.

  2. Select Create. The Create Static Field drawer opens.

  3. Choose the Module the field belongs to.

  4. Enter a Name. You can enter it in each of your languages.

  5. Enter a Code. It must be unique, and you can't change it later.

  6. Optional: choose a Parent Static Field to make this field depend on another one. For example, an amenity list can depend on a property category list.

    The Create Static Field drawer, with Module set to Core, a Name box with a tab for each language, an empty Code box and an optional Parent Static Field dropdown.
  7. Select Save.

Add options to a field

  1. In the field's row, select Options (n). The Options page for that field opens. A chip shows the module that manages it.

  2. Select Create. The Create Option drawer opens.

  3. Enter a Name and a Code. The code must be unique across every option of every field, and you can't change it later.

  4. Optional: set a Color, an Icon and an Image. The image can be jpg, jpeg, png, svg or webp, up to 2 MB.

  5. If the field has a parent, choose the parent options this option applies to, in Applicable parent field name.

    The Create Option drawer with Name, Code, Color, Icon, Order and Image fields, and the Applicable Amenity Category dropdown highlighted for choosing parent options.
  6. Select Save.

To add a similar option quickly, open an option's … menu and select Duplicate.

Put the options in order

Drag a row by its handle to a new position. With the keyboard, focus the handle and press Alt+↑ or Alt+↓, or use Move up and Move down. You see Order updated.

You can also type a number in the Order column. See Edit a value directly in a list.

Choose the default option

  1. Open the option's … menu.

  2. Select Set as default.

    The Options page for Amenity Category with the Community option's … menu open, showing Set as default highlighted above Edit, Duplicate and Delete.

The option is marked in the Default column, and the field's previous default is unmarked. Setting a default needs feature.core.static_option.edit.

What happens next

Dropdowns that use the field offer the new options straight away, in the order you set, with the default preselected.

You can't delete an option while it's the default, or if it's a system option. To delete one you added, open its … menu and select Delete. Deleting a field or an option is permanent: there's no trash for them.

To go back to the list of fields, select Back to fields.