Textlist Element
Render multiple lines of text from a delimited data field.
Textlist Element
The Textlist element renders multiple text lines from a single delimited source value — ideal for keyword tags, trait lists, or any set of short text items where each should appear as its own text line. Unlike the List element which repeats arbitrary child elements, Textlist renders each item directly as styled text with no child configuration needed.
Difference from List
| Feature | Textlist | List |
|---|---|---|
| Item rendering | Each item as a text line | Each item cloned as child elements |
| Child elements | None needed | Required — defines the per-item template |
| Configuration | Single element, styled centrally | Children can mix Text, Image, etc. |
| Best for | Simple text items, keywords, tags | Complex per-item layouts |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
Source | string | — | Data binding with a delimited list value |
Separator | string | , | Delimiter used to split the Source value |
MaxPerLine | number | — | Maximum number of items per rendered line |
Spacer | string | | Text inserted between items on the same line |
Align | string | Left | Horizontal alignment for each line |
Color | string | #000000 | Text color |
FontSize | number | 12 | Font size in points |
ListValue | string | — | Current list item value (available to child templates) |
Source
Source specifies the data binding whose value is split and rendered as text lines. Use {{ColumnName}} syntax to reference a spreadsheet column. The value is split by Separator and each part becomes one rendered item. If Source is empty for a card row, nothing is rendered.
Separator
Separator is the delimiter character used to split the Source value. The default is a comma (,). Change this if your data uses a different separator, such as a semicolon (;) or pipe (|).
MaxPerLine
MaxPerLine limits how many items appear on a single rendered line before wrapping to the next line. When not set (the default), each item appears on its own line. With MaxPerLine: 3, a five-item list produces two lines — one with three items and one with two. Items on the same line are joined by the Spacer text.
Spacer
Spacer is the text inserted between items that share a line when MaxPerLine is active. The default is a single space. Common values:
" • "— bullet-separated items", "— comma-separated inline list" | "— pipe-separated tags
Align
Align sets the horizontal alignment for all rendered text lines. Accepted values are Left (default), Center, and Right. All lines use the same alignment.
Color
Color sets the text color for all items in the list. Accepts #RRGGBB hex codes, CSS named colors, and [[ConstantName]] constant references. A single color applies uniformly to every item.
FontSize
FontSize sets the size in typographic points for all items. A single value applies to all rendered lines.
ListValue
ListValue holds the current list item value and is available to child templates. This property is set automatically during rendering — each iteration of the text list exposes the current item's text as ListValue, which child elements or nested templates can reference using {{ListValue}}.