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

CardWhat it holds
ImageA picture, with non-destructive adjustments
NoteRich text — checklists, mentions, formatting
LinkA URL, unfurled into a real preview with title and thumbnail
DocA whole multi-page document
PDFPage one as a thumbnail, opening into a full viewer
FileAny other file — type icon, size, download
VideoAn inline player
AudioA waveform player with cover art
PaletteA set of colours you can pull from
ShapeRectangle, ellipse, line, arrow, diamond, triangle, hexagon, star
Art canvasA bounded drawing surface that lives as a card
GridA split-cell layout — storyboards, contact sheets
ScheduleA real-date calendar you can drop things into
VoteAn up/down poll anchored anywhere
ClusterA nested board, opening into its own canvas
Linked clusterA reference to a cluster that lives elsewhere

Adding one

Four ways, in rough order of speed:

  1. Drag a file in from your desktop. The type is detected and the right card kind is created — see Files and media.
  2. Paste. A URL becomes a link card, an image in your clipboard becomes an image card, text becomes a note.
  3. Double-click empty canvas for an add menu at your cursor.
  4. 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.

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

Cards through the API

The REST API exposes a deliberately narrower card model than the canvas: doc, file, image, link, note, 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 100 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