Display Layouts
Keel tools support different display layouts depending on how users need to interact with data. Each layout is optimised for specific workflows.
Available layouts
| Layout | Best for | Learn more |
|---|---|---|
| Table | Scanning many records with sortable columns | Table Layout |
| Inbox | Working through items one at a time with a detail panel | Inbox Layout |
| Kanban | Managing workflow stages with drag-and-drop | Kanban Layout |
| Gallery | Visual content like products or images | Gallery Layout |
Default layout
List actions use the table layout by default. To change the layout, configure it in your tool's JSON file:
tools/list-orders.json
{
"action_name": "listOrders",
"layout": "inbox"
}Choosing a layout
Consider how users will work with the data:
- Table: Best when users need to compare many records, sort columns, or scan for specific entries. Use for reports, audit logs, and general record lists.
- Inbox: Best when users process items sequentially, need to see full details while maintaining context of the queue. Use for approvals, support tickets, and task lists.
- Kanban: Best when records move through defined stages and users benefit from visual progress tracking. Use for order fulfillment, project workflows, and pipeline management.
- Gallery: Best when visual identification matters more than textual data. Use for product catalogues, image libraries, and visual inventories.