Skip to content

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.

FieldTypeNotesSyncs
TitletextThe card’s name✅
StatusenumNot started / In progress / Done (plus backlog, review, archived)✅
Custom statustextA tracker status that doesn’t map to CardBoard’s enum✅
Descriptionrich textLong-form detail✅
Acceptance criteriarich textOptional checklist/criteria✅
Colorenumcolor_name (e.g. blue, yellow); groups cards visually❌
Shapeenumrectangle, diamond, circle, capsule, parallelogram, cylinder❌
SizevalueOptional sizing❌
Width / heightnumberFixed card dimensions❌
Position (x, y)numberMeaning depends on the map type❌
Parent cardreferenceHierarchy — load-bearing on tree/sitemap maps✅
Assigned userreferenceOptional assignee✅
ReactionslistEmoji feedback❌
CommentslistConversation threads❌
Tracker linkslistZero or more card↔tracker linksn/a
GroupslistOutcomes and journeys the card belongs to❌

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 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.)

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.