The list component renders one or more fields from a blueprint section as a clean formatted list. Use it for simple ordered or unordered outputs: key dates, named deliverables, personnel, milestones, or any set of repeating items that don't need a full table.
When to use
- A numbered list of key deliverables for an executive summary.
- An unordered list of active risks by title.
- A horizontal pill-style list of assigned contributors or team members.
- A labelled list showing key project dates (planned start, planned finish, data date).
Adding the component
- Open the report output in the Output Designer.
- Click + Insert → List.
- Position and resize the component.
- In the Data tab, bind a section and configure list fields.
Configuration
Data binding
| Property | Description |
|---|
| Source section | The blueprint section to pull rows from. Can be a single-record or repeating section. |
| Filter | Optional row-level filter (e.g. only show rows where Status = Active). |
| Sort field | Sort list items by a field value. |
| Max rows | Limit the number of items shown (e.g. top 5). |
Layout
| Property | Options |
|---|
| Orientation | Vertical (default) or Horizontal. |
| List style | None, Bullet, Numbered, Dash, Icon. |
| Icon source | If Icon style — choose a static icon or a field-mapped icon. |
| Item separator | None, line, or space. |
| Columns | 1–4 columns for vertical lists (wraps items across columns). |
Item fields
Each list item can display one or more fields:
| Property | Description |
|---|
| Primary field | The main text displayed for each item. |
| Secondary field | Optional sub-text shown below or beside the primary text (e.g. owner name, due date). |
| Badge field | Optional coloured chip shown beside the item (e.g. RAG status, priority). |
| Prefix label | Static label shown before the primary field (e.g. "Owner:"). |
Typography and spacing
| Property | Options |
|---|
| Font size | 10–18pt. |
| Font weight | Normal, Semi-bold, Bold. |
| Item padding | Compact, Normal, Spacious. |
| Colour | Static or conditional on a field value. |
Empty state
Configure what is shown when the section has no rows or all rows are filtered out:
| Property | Description |
|---|
| Empty text | Custom message shown when no items are available. |
| Hide when empty | Collapse the component entirely if there are no items. |
Export behaviour
- PDF / Word: Renders as a styled HTML list; numbering and bullets are preserved.
- Excel: Each item becomes a row in the output sheet.