Skip to Content
ReferenceCanvas objects

Canvas objects

Six kinds of object can sit on a derived canvas, and every one of them counts against the canvas object limit.

ObjectHow it gets on the canvasSent to the model?Kept in the library?
ImageGenerate, Upload, drag and drop, CmdVCtrlV, library drag, a finished generationYes, as an input imageYes
VideoUpload, drag and drop, library drag, a video-model generationYes, video modes onlyYes
Prompt blockPrompt in the pie menu or toolbar, Extract PromptYes, as the prompt textNo
Variable blockVariable in the pie menu or toolbarAs a value inside the promptNo
TextText in the pie menu or toolbarNoNo
StickerStickers in the pie menuNoNo

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, --q and --m tags in the text override aspect ratio, quality and model.

Variable block

What it is

  • A purple block holding one <name> : value pair.
  • 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.