Connections and references

Connections are how you feed context to AI. This is the core idea of the canvas.

This is the page that makes the rest of the canvas make sense.

A connection into a generation node is a reference. Everything you wire in becomes context the model receives.

Making a connection

Dragging from a connection handle

Hovering a node shows a + handle on each side. Drag from one to another node and release.

Direction is fixed: right is the output, left is the input. Dragging out of a left handle simply flips the relationship so the result still reads right to left.

While dragging, the line tells you whether the drop is valid:

Color	Meaning
Green	This connection is allowed
Red	Not allowed
Grey	Not over a target yet

What each source contributes

Text, table, YouTube

Their content is prepended to the prompt, labelled with the node’s name. This is how you give a generation a script, a shot description, or a summary.

Image, video, audio, panorama

Added as reference media, subject to the model’s limits for each type.

Dataset and bundle

Expanded into their member assets, so one connection can carry many references.

First and last frames

On models that support them, the frame slots are filled from connections rather than uploads.

A dataset node in content view contributes its text; in asset view it contributes its media. The same connection means different things depending on the node’s mode.

Multi-connect and fan-out

Gesture	Result
Select several nodes, drag any +	All of them connect to the target
Alt + drag + from a selection	Fan-out — each source gets its own new node, one to one
Drag out of a table node	One connected node per row

The multi-select toolbar shows an ⌥ badge as a reminder that Alt switches to fan-out.

You can also connect by tag: ⌥1–⌥8 with generation nodes selected connects every node carrying that tag to them.

What is not allowed

• A node cannot connect to itself
• The same connection cannot be made twice
• Group nodes cannot connect at either end
• A bundle can only feed a generation node
• Connections beyond a model’s reference limit are refused, with the reason given

Fine-tuning a connection

The reference list on a generation node

Connections carry more than “these are joined”:

• Disabled assets — for dataset and bundle sources, individual members can be excluded without removing the connection
• Reference role and label — what the reference is called, which is what @image1 addresses
• Frame slots — which connection is the first frame and which is the last

Manage these from the generate panel’s reference list, where you can also reorder references by dragging.

Removing a connection

Cutting a connection

Click the line. A scissors button appears at its midpoint — cut connection. You can also select a connection and press Backspace or Delete. Both can be undone.

When a generation is not picking up something you expect, check the connections before rewriting the prompt. A disabled dataset member or a reference dropped for exceeding the model’s limit looks exactly like a prompt that is not working.