Cards
A card is one thing on a board. Soleil Clusters has around fifteen kinds — image, note, link, document, PDF, file, video, audio, colour palette, shape, art canvas, grid, schedule, vote and nested cluster. Every card shares the same position, size, layer and selection behaviour, so what you learn on one applies to all of them.
Everything on a canvas is a card. They differ in what they hold and nothing else — position, size, stacking order, selection, grouping, tagging, commenting and duplication work identically on all of them.
Every kind
| Card | What it holds |
|---|---|
| Image | A picture, with non-destructive adjustments |
| Note | Rich text — checklists, mentions, formatting |
| Link | A URL, unfurled into a real preview with title and thumbnail |
| Doc | A whole multi-page document |
| Page one as a thumbnail, opening into a full viewer | |
| File | Any other file — type icon, size, download |
| Video | An inline player |
| Audio | A waveform player with cover art |
| Palette | A set of colours you can pull from |
| Shape | Rectangle, ellipse, line, arrow, diamond, triangle, hexagon, star |
| Art canvas | A bounded drawing surface that lives as a card |
| Grid | A split-cell layout — storyboards, contact sheets |
| Schedule | A real-date calendar you can drop things into |
| Vote | An up/down poll anchored anywhere |
| Cluster | A nested board, opening into its own canvas |
| Linked cluster | A reference to a cluster that lives elsewhere |
Adding one
Four ways, in rough order of speed:
- Drag a file in from your desktop. The type is detected and the right card kind is created — see Files and media.
- Paste. A URL becomes a link card, an image in your clipboard becomes an image card, text becomes a note.
- Double-click empty canvas for an add menu at your cursor.
- The tool rail or its + menu.
Cards you add without specifying a position are placed in free space, so a batch of twelve images arranges rather than stacking on top of what is already there.
What every card does
Move by dragging. Resize from the corners. Hold Alt while dragging to ignore snapping.
Layer order — [ and ] send backward and forward. Also in the right-click menu.
Duplicate — ⌘D.
Delete — ⌫. A toast offers undo; ⌘Z also works.
Cut and paste — ⌘X / ⌘V, including across clusters. Cut-paste keeps standard clipboard behavior: the cut is undoable on the board it happened on, the paste on the board it landed on. (Dragging cards onto a cluster card instead performs a true move, whose toast undoes both sides at once.)
Group — select several and press ⌘G. See Groups.
Tag — right-click → tag. See Tags.
Comment — right-click → comment, which anchors a bubble to that card. See Comments.
Copy link — a deep link that opens the board with that card selected. Useful in a message or a doc.
Titles
Most cards have a title. Double-click it to edit. Titles are searchable in ⌘K and they are what shows in list view, so a card called "Untitled" is a card you will not find later.
Shape cards are the exception — they have no title. If you need a labelled shape, put a note on top of it or use a group, which does have a name.
The card limit
The free Demo plan allows 50 cards in total across every cluster you create. Cards on clusters someone else owns do not count against you — if you are invited as an editor, you are spending their allowance, not yours.
Creator removes the limit entirely. See Plans.
Dropping more files than you have room for
If you drag in a folder with more files than your remaining allowance, Clusters asks before it uploads anything. You can add the ones that fit, upgrade to keep the whole folder, or cancel — and until you answer, nothing is uploaded and nothing on the canvas changes. Choosing to add the ones that fit always gives you every card you still have room for; the rest stay on your disk.
Cards through the API
The REST API exposes a deliberately narrower card model than the canvas: audio, doc, file, image, link, note, pdf, video. An API caller can set position, size, title, body, HTML, URL, image key and colour, and nothing else — interior state that belongs to the editor is not writable from outside.
Frequently asked questions
How do I change what kind a card is?
You do not convert cards between kinds. Create the kind you want and move the content across. The one exception is dropping a file, which picks the right kind for you automatically.
Is there a limit on cards?
The free Demo plan allows 50 cards across every cluster you create. Creator removes the limit. Clusters themselves are never capped.
What happens if I delete a card by accident?
Cmd-Z undoes it. Deletions also show an undo toast. Deleting a whole cluster is a soft delete that stays in the trash for 30 days.
Machine-readable: /docs/canvas/cards.md · /llms.txt
What changed and when: /changelog