Skip to content

Form Layout & Custom Fields

Administrators can change how forms look, add tenant-specific data fields, and control which columns appear on list screens. These tools apply across modules (Leave, Employees, Sales Orders, and others) wherever a form or list supports customization.

Permission What it unlocks
formlayout.update Design Mode on forms, restore default layout, and Column Settings on lists
customfield.update Create Data Field / edit / delete custom field definitions

Users without formlayout.update do not see Design Mode or Column Settings. Assign these scopes on the user’s role under Permissions.


Open any create/edit form that supports layout customization (example below: Leave → Records → + Create).

  1. In the form dialog header, click the ⋮ (vertical dots) menu.
  2. Choose Design Mode.
  3. The title shows (Design Mode). Layout changes auto-save after you move or edit fields.
Leave form in Design Mode
Control Action
Drag handle (six dots) on a field Drag the field to another place in the same row or another row
Red × on a field Remove the field from the layout (it moves to Available fields / Data fields so you can put it back)
Green ↑ / ↓ on a row Move the whole row up or down
Red × on a row Delete an empty or unwanted row
Clear / restore icon (header) Restore form layout to original (removes saved customization for this form)
Phone icon Mobile preview — check how fields wrap on a narrow screen
Eye / preview icon Exit Design Mode and return to normal data entry (Run mode)

A floating Available fields panel lists:

  • Preset controls you can drag onto the form (when provided for that form)
  • Data fields — removed built-in fields and custom fields not yet placed

Drag a field from that panel onto a row to put it back on the form.

In Design Mode, open a field’s settings (where available) to change:

  • Label (and optional translation)
  • Help text
  • Required

Use Restore Default on that dialog to undo property overrides for that field.

Click the preview / run-mode control in the header, or open ⋮ and turn Design Mode off. Your layout is already saved; close the form when finished.


Custom fields store extra data on an entity (for example Leave, Employee, Item). You create them from Design Mode.

  1. Enter Design Mode on the target form (see above).
  2. In the Available fields panel, click Create Data Field.
  3. Fill in the definition, then click Create.
  4. Drag the new field from Data fields onto the form layout.
Create Data Field dialog
Field Description
Field Name Internal key (no spaces). Used in APIs and storage.
Label Caption shown on the form. Use the translation icon to localize it.
Data Type Control type — e.g. Text, Number, Date, Textarea, Dropdowns, Radios, LOV, User, Employee, Customer, Master Detail, and others.
Required User must fill the field when creating/updating the record.
Help Text Hint or tooltip for end users.

Extra options appear by data type (for example Options for dropdowns/radios, LOV for list-of-values lookup, Flex List for flex-list lookup).

After create:

  1. Drag the field onto the layout.
  2. Optionally edit the definition later from the field’s edit control in the Data fields list.
  3. To remove it from the screen only, use × on the field in Design Mode (definition remains until you delete it).

Deleting a custom field definition (Delete on the Create/Edit Data Field dialog) removes the definition; confirm carefully — existing values may no longer be editable.

Requires customfield.update. Without it, Design Mode still works for layout, but Create Data Field is not available.


On list screens that support customization (gear / column settings in the grid toolbar), users with formlayout.update can change column order and visibility for everyone using that list setting.

Example: Leave → Records → open Column Settings.

Column Settings for Leave records
  1. Open the list.
  2. Click the column settings control (gear / settings) in the list header.
  3. In Column Settings:
    • Drag rows up/down to reorder columns.
    • Toggle Visible to show or hide a column.
  4. Click Save.
  5. Restore Default clears the saved column layout and returns to the product default.

Custom fields that are marked searchable / included in column settings can also appear in this list so you can show them as columns.