Skip to content

Card properties

The complete field list for a card. Most fields are CardBoard-only; only title and status sync to a tracker.

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
OutcomeslistNamed groups 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.

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.