Canvas objects
Six kinds of object can sit on a derived canvas, and every one of them counts against the canvas object limit.
| Object | How it gets on the canvas | Sent to the model? | Kept in the library? |
|---|---|---|---|
| Image | Generate, Upload, drag and drop, CmdVCtrlV, library drag, a finished generation | Yes, as an input image | Yes |
| Video | Upload, drag and drop, library drag, a video-model generation | Yes, video modes only | Yes |
| Prompt block | Prompt in the pie menu or toolbar, Extract Prompt | Yes, as the prompt text | No |
| Variable block | Variable in the pie menu or toolbar | As a value inside the prompt | No |
| Text | Text in the pie menu or toolbar | No | No |
| Sticker | Stickers in the pie menu | No | No |
Image
What it is
- A still image: an upload, a library image or a generation result.
- Registered in the library on upload and on generation.
How it gets on the canvas
- Generate in the pie menu or toolbar places an empty placeholder. It is removed if you click away without starting a job.
- Upload opens the file picker.
- Drag and drop a file onto the canvas.
- CmdVCtrlV pastes an image from the clipboard at the center of the viewport.
- Drag from the library. The copy keeps the library id, star and generation metadata.
- A finished generation.
- Extract Frame on a video.
- A Remove Background result.
- A Separate Layers result. One image per layer.
- A Split image result.
- A Paint over result.
- Duplicate: CmdDCtrlD (20 px offset), OptiondragAltdrag, or CmdCCtrlC / CmdVCtrlV. Copy-paste works on finished images only.
What it does in a generation
- Selected images are the input images, in selection order.
- Images are the only image input a model receives.
- Placeholders are not sent.
- Every model has an input limit. Extra thumbnails fade out and are not sent.
What you can do with it
- Re-generate, or Retry on a failed image.
- Crop.
- Paint over.
- Split image.
- Separate layers. Billed.
- Select Prompt, Extract Prompt, Load Prompt.
- Select Image Sources, Extract Image Sources.
- Get All Params.
- Compare (C). One image with provenance, or exactly two finished images.
- Define Smart Ref, Add to Smart Ref.
- Copy as PNG (CmdShiftCCtrlShiftC).
- Remove Background.
- Download (CmdSCtrlS).
- Download as .psb. Two or more images selected.
- Set as Cover.
- Rename. Changes the library display name.
- Add comment.
- Tidy (G). Two or more objects selected.
- Remove from Canvas (Delete).
- Star: a badge on hover or selection toggles the library star.
- Tags: there is no tag action on the canvas. Tags are set by the auto-tagger at upload.
Rules and limits
- Upload formats: PNG, JPEG, WebP, GIF, AVIF.
- AVIF is converted on upload.
- A GIF is treated as a video. See Video.
- Upload limit 10 MB. The client compresses toward 9.5 MB first.
- Crop is non-destructive. The crop rectangle is stored on the object.
- The star lives on the library row. Every canvas copy of the same library image shares it.
- Renders in the bottom layer, under text, prompt and variable blocks.
- Remove from Canvas deletes the canvas object only. The library image stays.
- Comments on the object are deleted with it.
- If the library image is deleted later, the canvas object becomes a “This image was deleted from the library” placeholder.
Video
What it is
- A video clip. There is no Video item in the pie menu or toolbar.
- Registered in the library on upload, as a poster and a clip.
How it gets on the canvas
- Upload or drag and drop an MP4, MOV, WebM or GIF.
- Drag from the library.
- A video-model generation.
- Combine videos.
- Duplicate: CmdDCtrlD (20 px offset), OptiondragAltdrag, or CmdCCtrlC / CmdVCtrlV. Copy-paste works on finished clips only.
- CmdVCtrlV does not paste a video from the clipboard. Paste handles images only.
- While uploading it shows “Uploading N%”, then “Processing…” or “Converting GIF…”.
What it does in a generation
- Sent to video models only. Image models ignore videos.
- Video-to-video: the first selected video is the source clip.
- Reference-to-video: every selected video is a reference, in selection order.
What you can do with it
- Re-generate, or Retry on a failed video.
- Select Prompt, Extract Prompt, Load Prompt.
- Select Image Sources, Extract Image Sources.
- Get All Params.
- Convert to atlas.
- Extract Frame: First, Last or Custom.
- Combine videos. Two to six finished videos, nothing else selected.
- Download.
- Rename.
- Add comment.
- Tidy.
- Remove from Canvas.
- Star badge, as for images.
- Not available on video: Crop, Paint over, Compare, Remove Background, Copy as PNG, Set as Cover, Smart Ref.
- There is no trim action on the canvas. Trim exists only in Packshot.
Rules and limits
- Upload limit 15 MB.
- A GIF is transcoded to MP4 on upload and loops.
- Other formats are stored as they are.
- Remove from Canvas deletes the canvas object only. Comments on it are deleted with it.
- Delete is blocked while an upload is in flight: “Still uploading — wait for it to finish before deleting.”
- A failed upload can be dismissed.
Prompt block
What it is
- An amber block holding prompt text.
- Canvas only. Not kept in the library.
How it gets on the canvas
- Prompt in the pie menu or toolbar. Editing opens immediately.
- Extract Prompt on a generated image or video.
- Duplicate: CmdDCtrlD (20 px offset), OptiondragAltdrag, or CmdCCtrlC / CmdVCtrlV.
What it does in a generation
- Sent as the prompt text. Never as an image.
- The first selected prompt block is the prompt. Its text is the template.
- Variables are substituted only when a prompt block is selected. Text typed into the panel is never substituted.
What you can do with it
- Double-click to edit. Enter finishes, ShiftEnter adds a newline.
- Resize changes the width only. Rotation is locked.
- Copy Text.
- Tidy.
- Remove from Canvas.
- Images generated from it remember its id. Delete the block and Extract Prompt on those images rebuilds it.
Rules and limits
<name>is a variable slot. An unfilled variable greys out Generate.{SmartRefName}expands to the smart ref’s description. Typing{opens autocomplete.--ar,--qand--mtags in the text override aspect ratio, quality and model.
Variable block
What it is
- A purple block holding one
<name> : valuepair. - Canvas only. Not kept in the library.
How it gets on the canvas
- Variable in the pie menu or toolbar. Editing opens immediately.
- Duplicate: CmdDCtrlD (20 px offset), OptiondragAltdrag, or CmdCCtrlC / CmdVCtrlV.
What it does in a generation
- Sent as a value only.
- Every selected variable block is read as name and value, and the value is substituted into the selected prompt’s
<name>slot. - Name matching is case-insensitive.
- Several selected blocks with the same name fan out into one generation per value.
- Different names combine. One generation per combination.
What you can do with it
- Double-click to edit. The content is validated on blur. A red outline means the format is wrong.
- Resize changes the width only. Rotation is locked.
- Copy Text.
- Tidy.
- Remove from Canvas.
Rules and limits
- The content must read
<name> : value. - It starts with
<. The name is letters, digits,_or-. Then:, then the value. - The value is everything after the first colon. Values may contain colons.
- Anything else is ignored.
Text
What it is
- A text label with no background.
- Canvas only. Not kept in the library.
How it gets on the canvas
- Text in the pie menu or toolbar. Editing opens immediately.
- Duplicate: CmdDCtrlD (20 px offset), OptiondragAltdrag, or CmdCCtrlC / CmdVCtrlV.
- Pasting clipboard text with CmdVCtrlV does not create a text object.
What it does in a generation
- Nothing. Text is never sent to a model.
- Select only text and the generation panel does not open.
- Mixed with images, text is ignored.
- Paint over ignores it.
What you can do with it
- Double-click to edit.
- Resize changes the width only. Rotation is locked.
- Font size presets in the bottom dock when only text is selected: Small 36, Medium 54, Large 96.
- Copy Text.
- Tidy.
- Remove from Canvas.
Rules and limits
- Renders above images and videos.
Sticker
What it is
- A colored shape: a circle, triangle or square in one of 12 colors.
- Canvas only. Not kept in the library.
How it gets on the canvas
- Stickers in the pie menu. Not on the toolbar.
- The picker offers Circle, Triangle and Square in 12 colors.
- Duplicate: CmdDCtrlD (20 px offset), OptiondragAltdrag, or CmdCCtrlC / CmdVCtrlV.
What it does in a generation
- Nothing. Stickers are never sent to a model.
- Never part of lineage, smart refs, the library, Packshot or a download.
What you can do with it
- Move, rotate and scale. Scale is uniform.
- Remove from Canvas. Nothing else.
- Excluded from Tidy.
Rules and limits
- Always on top. Renders above everything else regardless of layer order.
- Shape and color cannot be changed after placing. Delete it and add another.
The generating placeholder
- An image object (a video object for video models) in a placeholder state. Not a separate type.
- Created the moment Generate is pressed. Saved before the request is sent.
- Survives a page reload.
- A box with a spinner and a caption: “Generating…”, “Removing background…”, “Combining…”, “Separating layers…”, or “Still working — taking a bit longer.” on a retry. The prompt text sits under it.
- A failed one turns red and shows the error text.
- It can be selected.
- It can be deleted.
- Deleting it does not cancel the job and does not refund the units. A started generation is charged. Units are refunded only on failure.
- The finished image is still saved to the library.
- Until it finishes it cannot be duplicated with OptiondragAltdrag, copy-pasted, cropped, painted over, compared, renamed, commented or set as cover.
- The pie menu Generate item places a pre-submit placeholder with no job. It disappears if you click elsewhere without generating.