Model Configuration
Model Configuration lets you define how model fields render across your entire application. When you configure a field here, that configuration applies everywhere the field appears — in tables, record views, embedded lists, and every tool that uses that model.
Tool-level field formatting overrides Model Configuration for a specific tool. Model Configuration is the global default.
Accessing Model Configuration
There are two ways to access Model Configuration.
Via Tool Settings
Tool Settings has four tabs: Actions, Models, Enums, and Flows. The Models tab is where you manage model-level field configuration:
- Open Tool Settings from the sidebar
- Click the Models tab
- Select a model, then select a field
- Edit the field's display settings in the panel on the right
Changes saved here apply globally across all tools immediately.
If the field you select uses an enum type, the panel will show a button to navigate to the Enums tab instead of inline formatting options. Enum configuration is managed separately — see Enum Configuration.
Via the tool configuration sidebar
You can also edit Model Configuration from within any individual tool. This is useful when you notice a field needs a global change while you're already working on a tool:
- Open a tool
- Click Configure [tool name] from the actions menu (⋯)
- In the sidebar that opens, click the Data tab (or Response for write actions)
- Select a field from the list
- At the top of the field settings, set the scope toggle to Global
When the scope is set to Global, you're editing Model Configuration directly — changes affect every tool that displays that field, not just the current one.
When the scope is set to Action, you're configuring the field only for this tool. Action-level settings override Model Configuration.
The scope toggle defaults to Action and resets to Action whenever you navigate to a different tool. It only appears for response fields that map to a model field — input-only fields don't have a global equivalent.
Some options — conditional visibility and action links — are only available at action scope. They don't exist in Model Configuration.
Override indicators
When viewing a field in Global scope via the tool configuration sidebar, fields that have been overridden at the action level display an indicator. This lets you see at a glance which global settings a particular tool is diverging from.
Display settings
Every field type supports these display options:
| Option | Description |
|---|---|
| Label | Custom name shown in column headers and field labels instead of the field name |
| Visible | Whether the field is shown by default. Hidden fields can still be used in filters and actions |
| Image preview | For file and image fields, shows inline thumbnails in tables and record views |
Number formatting
Number fields support five display modes, plus options for locale, colours, prefixes, suffixes, and sensitive data handling.
Format modes
| Mode | Description | Example output |
|---|---|---|
DECIMAL | Standard decimal with locale formatting (default) | 1,234.56 |
RAW | No formatting applied | 1234.56 |
CURRENCY | Currency symbol and formatting from the selected currency code | £1,234.56 |
PERCENTAGE | Percentage display | 12.5% |
UNIT | Quantity with a measurement unit | 150 kg |
Currency
Select CURRENCY mode and choose an ISO 4217 currency code. Common codes include GBP, USD, EUR, JPY, CAD, and AUD.
Units
Select UNIT mode and enter a unit code. Simple units like kilogram and kilometer work, as do compound units like meter-per-second.
Locale
All number modes use the browser's locale by default. Set an explicit locale code (e.g. en-US, de-DE) if you need consistent formatting regardless of where your users are located. Leave the field empty to auto-detect.
Conditional colouring
The Colourise option applies a colour based on whether the value is positive or negative:
| Mode | Positive values | Negative values |
|---|---|---|
NONE | No colour (default) | No colour |
NORMAL | Green | Red |
INVERTED | Red | Green |
Use INVERTED when a negative value is desirable — for example, a cost reduction or a discount amount.
Number formatting options
| Option | Type | Description |
|---|---|---|
| Mode | string | DECIMAL, RAW, CURRENCY, PERCENTAGE, or UNIT |
| Currency code | string | ISO 4217 code, required for CURRENCY mode |
| Unit code | string | Unit identifier, required for UNIT mode |
| Locale | string | Locale code for formatting. Auto-detected if empty |
| Prefix | string | Text prepended to the formatted value |
| Suffix | string | Text appended to the formatted value |
| Colourise | string | NONE, NORMAL, or INVERTED |
| Sensitive | boolean | Masks the value until the user hovers over it |
Boolean formatting
Boolean fields display as true / false by default. You can replace these with custom labels and assign colours to each state. Colours are entered as hex codes.
| Option | Description |
|---|---|
| True label | Text displayed when the value is true |
| True colour | Hex colour applied when the value is true |
| False label | Text displayed when the value is false |
| False colour | Hex colour applied when the value is false |
For example, an inStock field might use In Stock with green (#22c55e) and Out of Stock with red (#ef4444).
String formatting
String fields support prefixes, suffixes, text colours, URL previews, and sensitive data masking.
| Option | Description |
|---|---|
| Prefix | Text prepended to the value |
| Suffix | Text appended to the value |
| Text colour | Hex colour applied to the displayed text |
| Show URL preview | Renders the field as a clickable link when the value is a URL |
| Sensitive | Masks the value until the user hovers over it |
Use Show URL preview for fields like trackingUrl or websiteUrl so users can follow the link directly from a table row.
Enum formatting
Enum fields are configured separately in the Enums tab of Tool Settings. Selecting an enum-type field in the Models tab shows a button that navigates you there.
See Enum Configuration for the full reference.