Card properties
The complete field list for a card. The work-item fields — title, status, description, acceptance criteria, parent, and assignee — sync to a tracker; the visual and canvas fields are CardBoard-only.
| Field | Type | Notes | Syncs |
|---|---|---|---|
| Title | text | The card’s name | ✅ |
| Status | enum | Not started / In progress / Done (plus backlog, review, archived) | ✅ |
| Custom status | text | A tracker status that doesn’t map to CardBoard’s enum | ✅ |
| Description | rich text | Long-form detail | ✅ |
| Acceptance criteria | rich text | Optional checklist/criteria | ✅ |
| Color | enum | color_name (e.g. blue, yellow); groups cards visually | ❌ |
| Shape | enum | rectangle, diamond, circle, capsule, parallelogram, cylinder | ❌ |
| Size | value | Optional sizing | ❌ |
| Width / height | number | Fixed card dimensions | ❌ |
| Position (x, y) | number | Meaning depends on the map type | ❌ |
| Parent card | reference | Hierarchy — load-bearing on tree/sitemap maps | ✅ |
| Assigned user | reference | Optional assignee | ✅ |
| Reactions | list | Emoji feedback | ❌ |
| Comments | list | Conversation threads | ❌ |
| Tracker links | list | Zero or more card↔tracker links | n/a |
| Outcomes | list | Named groups the card belongs to | ❌ |
Status values
Section titled “Status values”The full status set is none, unstarted, started, completed, backlog, review,
archived, and custom. The UI collapses these to three visible states — Not Started
(unstarted), In Progress (started), Done (completed) — and custom shows the
card’s custom_status text, used to mirror a tracker status that doesn’t fit CardBoard’s
enum.
Card font size
Section titled “Card font size”Card font size is a board-level setting, not a per-card field. From the board’s settings, adjust the card font size to scale the text on every card on the board at once — handy for fitting more content or improving legibility. Because it applies to the whole board, it isn’t stored per card, so it doesn’t appear in the field table above or in the API. (For free-floating text that scales with zoom instead, see text stickers.)
What the API returns
Section titled “What the API returns”The REST API exposes: id, name, version, uuid, x, y, z_index, color_name, description, styled_description, status, custom_status, size, shape, fixed_width, fixed_height, created_at, updated_at, deleted_at, with optional comments, reactions, and
tracker_links. Note the public contract uses color_name (not the legacy color) and the
string shape.
For which of these survive a spreadsheet round-trip, see CSV import/export.