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

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.