Overview
The Icon Chooser field type (iconchooserfw) provides a visual icon picker that allows users to select an icon from the Font Awesome icon library. The selected icon is stored on the record and can be used for display purposes such as menu icons, category visuals, and record identification.
Properties
| Property | Required | Description |
|---|---|---|
| ID | Yes | The field identifier. |
| Type | Yes | Must be set to iconchooserfw |
| Name | Yes | The display label. |
| Width | No | The percentage width. |
| Help | No | Tooltip text. |
| Visibility | No | A condition controlling visibility. |
How It Works
- The user clicks the icon field to open the icon picker
- A searchable grid of available icons is displayed
- The user can search by keyword (e.g. "chart", "user", "warning")
- Clicking an icon selects it and closes the picker
- The selected icon is displayed in the field and stored on the record
Use Cases
- Category icons — assigning visual icons to knowledge base categories or entity types
- Menu customisation — selecting icons for custom menu items or navigation
- Visual classification — adding visual markers to records for quick identification
Best Practices
- A width of 50% or less is typically sufficient, as the icon display is compact
- Use alongside a name or title field to create visually distinct categories or types