Option Lists
Manage configurable dropdown lists used across the platform.
Overview
Lists provide configurable sets of values for dropdown menus throughout Signals. They replace hard-coded enums with user-manageable options, allowing each installation to customise categories, types, and classifications.
Option Lists
Route: /admin/settings/option-lists
Each list has a unique name, optional description, and two flags:
| Property | Description |
|---|---|
| Name | Unique identifier for the list |
| Description | What the list is used for |
| Hierarchical | Whether values can have parent-child relationships |
| System | Whether the list is built-in (cannot be deleted) |
System lists are seeded during installation and provide the foundation for contact detail types and other core features.
Managing List Entries
Route: /admin/settings/option-lists/{optionList}/entries
Each list contains values that appear as dropdown options. Values have:
| Property | Description |
|---|---|
| Name | The display text |
| Parent | Parent value (hierarchical lists only) |
| Sort Order | Display position |
| System | Whether the value is built-in |
| Active | Whether the value appears in dropdowns |
System values cannot be edited or deleted. Non-system values can be deactivated (hidden from dropdowns while preserving existing references).
Built-in Lists
| List | Used For |
|---|---|
| Activity Type | Activity type classification (e.g. Task, Call, Email, Meeting) |
| Address Type | Address classification (e.g. Head Office, Branch, Billing) |
| Email Type | Email classification (e.g. Work, Personal, Support) |
| Phone Type | Phone classification (e.g. Mobile, Landline, Fax) |
| Link Type | Link classification (e.g. Website, LinkedIn, Twitter) |
| Relationship Type | Account relationship roles (e.g. Employee, Director, Contractor, Agent) |
| Location Type | Location classification (Internal, External) |
| Rating | Star ratings (None through 5 Stars) |
| Invoice Term | Payment terms (Due on Receipt, Net 7–90, End of Month) |
| Locale | UI/locale codes (en-GB, en-US, fr-FR, …) |
| File Category | Attachment category labels |
| Vehicle Type | Fleet vehicle classification |
| Vehicle Assignment Role | Vehicle assignment role (Delivery, Collection, …) |
| Facility Type | Facility classification |
| Service Resource Type | Service resource kind (Crew) |
Note
Built-in option lists are stored with spaces (e.g. Activity Type), exactly as shown in the Settings → Option Lists UI. Query the API by the exact stored name, e.g. ?filter[name][eq]=Activity Type.
Rental Status
Rental Status is a list like any other, but it has a second, purpose-built editor. Its entries carry the workflow identity of a rental — the owning state, the composite code, and which built-in status a custom entry derives from — plus the colour used on diary cards and status badges.
Add, archive, delete, recolour, and relabel rental statuses under Admin → Setup → Branding → Status & schedule colours, or over /api/v1/rental_statuses. That surface understands the rules the generic option lists editor does not: custom codes start at 50, derives_from must name a built-in in the same state, identity keys are frozen after creation, and a status that appears in recorded history can be archived but never deleted. Editing the same metadata through Option Lists is possible but has none of those guardrails. See Branding and Colour Coding.
Using Lists in Custom Fields
Select and MultiSelect custom field types reference a list as their value source. When creating a custom field with these types, you select which list provides the dropdown options.
At a glance
Manage configurable list definitions used for dropdown menus.
| Action | Description |
|---|---|
| Create | Add a new list definition |
| Edit | Update option list and description |
| Manage Values | Navigate to the list's values page |
| Delete | Remove a non-system list |
List entries (/admin/settings/option-lists/{optionList}/entries) are not a sidebar item — open them from Manage Values on an option list.