Blueprint Field Types
Every field in a blueprint has a type that controls how data is entered in form mode, how it appears in grid mode, and how it can be bound and formatted in output components.
This page is the complete field type reference. For setup steps see Create Your First Blueprint. For conditional visibility between fields see Conditional Field Visibility. For the lookup field see Lookup Fields.
Text fields
Text
Short single-line plain text.
| Property | Description |
|---|---|
| Max length | Character limit (optional). |
| Placeholder | Hint text shown inside the empty field. |
| Default value | Value pre-filled on edition creation. |
| Pattern validation | Regex pattern the value must match (optional). |
Form mode: Single-line text input.
Grid mode: Inline editable cell.
Output binding: Displayed as text in table cells, KPI card titles, and text components.
Textarea
Multi-line plain text for notes and short descriptions.
| Property | Description |
|---|---|
| Max length | Character limit. |
| Rows | Default visible height of the input. |
Form mode: Multi-line text area.
Grid mode: Inline editable cell; expands on click.
Output binding: Plain text — line breaks rendered as paragraphs.
Rich text
Formatted narrative text with a full toolbar editor.
Supported formatting: headings (H1–H4), paragraph text, bold, italic, underline, strikethrough, ordered and unordered lists, blockquote, horizontal rule, inline code, inline images, tables, and hyperlinks.
Form mode: Full WYSIWYG editor. Paste from Word with formatting preserved.
Grid mode: Rich text fields are not editable inline — click to open a full-screen editor.
Output binding: Rendered as formatted HTML in text components and table cells. Rich text is not supported in chart value wells.
Numeric fields
Number
Integer or decimal numeric value.
| Property | Description |
|---|---|
| Decimal places | Fixed decimal display precision (optional). |
| Min / Max | Validation range. |
| Unit | Suffix label shown beside the value (e.g. "days", "m²"). |
| Default value | Pre-filled value. |
Form mode: Numeric input with unit suffix.
Grid mode: Inline numeric input; right-aligned by default.
Output binding: Supports aggregation (Sum, Average, Count, Min, Max, First, Last) in table value wells, chart series, and KPI value fields. Number format controlled in the Format panel.
Currency
Monetary value with currency symbol.
| Property | Description |
|---|---|
| Currency code | ISO 4217 code — AUD, USD, GBP, EUR, etc. |
| Decimal places | 0 or 2 (default 2). |
| Min / Max | Validation range. |
Form mode: Numeric input with currency prefix.
Grid mode: Inline numeric cell.
Output binding: Formatted with currency symbol in outputs. Aggregates as Number.
Percent
Decimal fraction displayed as a percentage.
Storage: Value is stored as a decimal (0.75 = 75%). The blueprint stores the decimal; the display layer applies the % suffix and multiplies by 100.
| Property | Description |
|---|---|
| Decimal places | Number of decimal places shown after the %. |
| Min / Max | Validation range (use decimals: 0 to 1). |
Form mode: Numeric input with % suffix.
Grid mode: Inline editable percent cell.
Output binding: Displayed with % format; aggregates as Number. Used for progress bars, gauge, and percent-format number labels in charts.
Date and time fields
Date
Calendar date without time.
| Property | Description |
|---|---|
| Date format | Display format: DD/MM/YYYY, MM/DD/YYYY, YYYY-MM-DD, or locale default. |
| Min / Max date | Date range constraint. |
| Default | Fixed date, or today / edition start / edition end token. |
Form mode: Calendar picker with keyboard input.
Grid mode: Inline date picker.
Output binding: Used in timeline axes (Gantt, Cash Flow, MTA), date dimension rows in tables, and KPI date fields. Date format applied in the Format panel.
Datetime
Date and time combined.
| Property | Description |
|---|---|
| Time zone | Store in UTC or a fixed offset. |
| Minute step | Rounding interval for the time picker (default 15 minutes). |
Form mode: Combined date and time picker.
Grid mode: Inline editable cell.
Output binding: Displayed as formatted date-time string. Can be used as a date dimension with time-of-day grouping.
Choice fields
Select
Single choice from a predefined option list.
| Property | Description |
|---|---|
| Options | Static list of label/value pairs. |
| Display order | Alphabetical or custom order. |
| Default value | Pre-selected option. |
| Allow other | If enabled, contributor can type a free-form value. |
Form mode: Dropdown selector.
Grid mode: Inline dropdown cell.
Output binding: Filtered and grouped in table rows and chart dimensions. Option values are used in conditional formatting colour rules.
Use Select for any field where consistent wording matters — Status, Priority, Discipline, Category. Free text for these fields leads to aggregation problems in outputs.
Multi-select
Multiple choices from a predefined option list.
| Property | Description |
|---|---|
| Options | Static list of label/value pairs. |
| Min / Max selections | Validation constraints. |
| Delimiter | Separator used when displaying selected values in grid cells (default , ). |
Form mode: Chip selector — click options to toggle.
Grid mode: Inline multi-select chip selector.
Output binding: Supported as a text field (joined values). For dimension grouping, use a single Select field instead.
Boolean and status fields
Toggle
Binary yes/no value.
| Property | Description |
|---|---|
| Default | On or off. |
| Label (on) | Text shown when the toggle is on (default "Yes"). |
| Label (off) | Text shown when the toggle is off (default "No"). |
Form mode: Toggle switch with on/off labels.
Grid mode: Checkbox cell.
Output binding: Displayed as the configured label text or as a boolean indicator icon.
RAG
Red / Amber / Green status indicator — the most widely used status field type in project reporting.
| Property | Description |
|---|---|
| Include "Not set" | Allow a neutral/unset state in addition to R / A / G. |
| Custom labels | Override the default Red / Amber / Green display labels. |
| Custom colours | Override the default colour palette per value. |
Form mode: Coloured chip picker — R / A / G buttons.
Grid mode: Coloured chip cell with dropdown.
Output binding: Renders as coloured RAG chip, coloured cell background in tables, or fills the indicator and RAG grid components. Used in conditional formatting rules across all component types.
Rating
1–5 star rating.
| Property | Description |
|---|---|
| Max rating | Maximum stars (default 5; supports 3, 5, or 10). |
| Allow half stars | Enable 0.5-step ratings. |
Form mode: Interactive star selector.
Grid mode: Star display; click to change.
Output binding: Numeric value — aggregates as Average, Sum, or Count. Can render as stars or as a number in output components.
Upload fields
Image
Image file upload stored against the edition record.
| Property | Description |
|---|---|
| Accepted formats | JPEG, PNG, GIF, WebP, SVG. |
| Max file size | In MB — default 10 MB. |
| Max files | Number of images allowed. |
| Thumbnail size | Size of the preview displayed in form mode. |
Form mode: Upload control with drag-and-drop; thumbnail preview after upload.
Grid mode: Shows a thumbnail; click to expand or replace.
Output binding: Bindable to Image and Image Gallery output components. Images are rendered inline in outputs.
File
File attachment for any document type.
| Property | Description |
|---|---|
| Accepted MIME types | Restrict to specific file types (optional). |
| Max file size | In MB — default 25 MB. |
| Max files | Number of attachments allowed. |
Form mode: File upload control with file list.
Grid mode: Shows attachment count badge; click to manage.
Output binding: Not rendered inline in output components. Accessible from the report viewer as a linked attachment.
Link fields
URL
Hyperlink with display text and URL.
| Property | Description |
|---|---|
| URL validation | Must begin with http:// or https://. |
| Open in new tab | Default for links in form and grid mode. |
Form mode: Two inputs — display text and URL.
Grid mode: Shows display text as a clickable link.
Output binding: Rendered as a hyperlink in text components. Not supported as a chart or table value field.
Email
Email address with format validation.
| Property | Description |
|---|---|
| Validation | Validates RFC 5322 email format. |
| Default value | Optional pre-filled email address. |
Form mode: Single-line email input.
Grid mode: Inline editable cell.
Output binding: Displayed as a mailto: link in text components and table cells.
Advanced fields
Computed
Read-only field whose value is calculated from other fields in the same section using a formula expression.
| Property | Description |
|---|---|
| Expression | Formula using field references, operators, and functions. |
| Output type | Number, Currency, Percent, Date, or Text. |
| Decimal places | Display precision. |
Form mode: Read-only display — value updates when referenced fields change.
Grid mode: Read-only column — value recalculates per row.
Output binding: Treated as the configured output type. Aggregates normally in output wells.
Computed fields support the same expression functions as the Output Designer expression engine. See Expression Reference.
Lookup
Pulls a value from a field in another blueprint's edition. The value is read-only in the edition — it is resolved at render time from the configured source blueprint.
| Property | Description |
|---|---|
| Source blueprint | The blueprint to pull data from. |
| Source section | The section within the source blueprint. |
| Source key field | The field in the source that matches a field in this blueprint. |
| Source return field | The field whose value is returned into this field. |
| Match field | The field in this blueprint that must match the source key field. |
| Lookup scope | latest (default), specific (pin to a particular edition), or all (return all matching values). |
Form mode: Read-only chip or text showing the resolved value.
Grid mode: Read-only column.
Output binding: Treated as the return field's type.
See Lookup Fields for the full configuration guide.
Field type compatibility summary
| Type | Form input | Grid cell | Chart value | Table row | KPI value | Conditional formatting |
|---|---|---|---|---|---|---|
| Text | ✓ | ✓ | — | ✓ | ✓ | — |
| Textarea | ✓ | ✓ | — | ✓ | — | — |
| Rich text | ✓ | ✓ (editor) | — | ✓ | — | — |
| Number | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Currency | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Percent | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Date | ✓ | ✓ | ✓ (axis) | ✓ | ✓ | ✓ |
| Datetime | ✓ | ✓ | ✓ (axis) | ✓ | — | — |
| Select | ✓ | ✓ | ✓ (dim) | ✓ | ✓ | ✓ |
| Multi-select | ✓ | ✓ | — | ✓ | — | — |
| Toggle | ✓ | ✓ | ✓ (count) | ✓ | — | ✓ |
| RAG | ✓ | ✓ | ✓ (count) | ✓ | ✓ | ✓ |
| Rating | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Image | ✓ | ✓ | — | — | — | — |
| File | ✓ | ✓ | — | — | — | — |
| URL | ✓ | ✓ | — | ✓ | — | — |
| ✓ | ✓ | — | ✓ | — | — | |
| Computed | (read-only) | (read-only) | ✓ | ✓ | ✓ | ✓ |
| Lookup | (read-only) | (read-only) | depends | depends | depends | depends |
Related
- Create Your First Blueprint
- Blueprint Form Designer
- Conditional Field Visibility
- Lookup Fields
- Expression Reference
- Advanced Computed Fields — nested IF, SWITCH, date arithmetic, null-safe patterns
- Data Validation Rules — numeric, text, date, and cross-field validation
- Field Validation Reference — complete table of validation options per field type
- Fields Panel — adding and configuring fields in the Blueprint Designer
- AI Design — AI can suggest field names and types from an uploaded document