Connecting Nodes

Connections are what turn individual nodes into powerful workflows. Learn how to link nodes together to create complex content generation pipelines.

Understanding Connections

Connections are the lines that link nodes together. They represent the flow of data from one node to another.

Basic Concept

[Node A] ──────→ [Node B]
 Output          Input

Data flows from the output of one node to the input of another.

Connection Handles

Every node has handles—small circles where connections attach:

Color-Coded Types

Connections are color-coded by data type:

Why Colors Matter

Colors help you understand:

• What type of data a node produces
• What type of data a node accepts
• Whether a connection is valid

Creating Connections

Step-by-Step

1. Locate the output handle — Small circle on the right side of the source node
2. Click and hold — On the output handle
3. Drag — A line appears following your cursor
4. Drop on input handle — Left side of the target node
5. Connection created — Line snaps into place

Visual Feedback

• Dragging: Line follows your cursor
• Valid target: Input handle highlights
• Connected: Solid line between nodes

Connection Rules

Basic Rules

1. Output to Input — Always connect from right (output) to left (input)
2. One output, many inputs — An output can connect to multiple inputs
3. Type compatibility — Some types can connect to others

Type Compatibility

Text is Special

Text (yellow) connections are the most flexible—they can connect to almost any input that accepts text, including:

• Prompt inputs on Image nodes
• Prompt inputs on Video nodes
• Script inputs on Audio nodes
• Text inputs on other Text nodes

Multi-Input Nodes

Some nodes accept multiple inputs:

Image Node Example

[Text Node] ────→ [Image Node] ←──── [Upload Node]
   Prompt              ↓           Reference Image
              Generated Image

The Image node accepts:

• Prompt (text) — What to generate
• Reference Image (image) — Style or content reference

Video Node Example

[Text Node] ────→ [Video Node] ←──── [Upload Node]
   Prompt              ↓           Starting Image
              Generated Video

Deleting Connections

Method 1: Select and Delete

1. Click on the connection line
2. Press Delete or Backspace

Method 2: Right-Click

1. Right-click on the connection
2. Select Delete from the menu

Method 3: Drag Away

1. Click on the input handle end
2. Drag away from the node
3. Release in empty space

Common Workflow Patterns

Linear Chain

Simple sequence of operations:

[Text] → [Image] → [Upscaler]

Branching

One output feeds multiple nodes:

→ [Image Node 1]
[Text] ─┤
         → [Image Node 2]

Merging

Multiple inputs to one node:

[Text] ────→ [Video Node]
                  ↑
[Upload] ─────────┘

Complex Pipeline

[Text] → [Text (AI)] → [Image] → [BG Remover] → [Image (new BG)] → [Upscaler]

Building Effective Workflows

Planning Your Flow

Before connecting, think about:

1. What's your input? — Text, image, or upload?
2. What's your output? — Image, video, audio?
3. What steps in between? — Processing, enhancement?

Example: Product Photo Workflow

Goal: Create professional product image with custom background

Plan:

1. Upload product photo
2. Remove background
3. Generate new background
4. Combine and enhance
5. Upscale for final quality

Workflow:

[Upload] → [BG Remover] → [Flux Kontext] → [Upscaler]
                               ↑
                          [Text: "marble surface, studio lighting"]

Troubleshooting Connections

Connection Won't Form

Causes:

• Incompatible types (e.g., image to text input)
• Trying to connect input to input
• Trying to connect output to output

Solutions:

• Check color compatibility
• Ensure you're going output → input
• Try a different input handle

Connection Looks Wrong

Causes:

• Connected to wrong input
• Meant to connect to different node

Solutions:

• Delete and recreate
• Double-check target node

Workflow Not Running Correctly

Causes:

• Missing connections
• Wrong connection order
• Circular dependencies

Solutions:

• Verify all required inputs are connected
• Check the flow direction
• Ensure no loops in your workflow

Tips for Clean Workflows

Organization

• Left to right — Keep flow direction consistent
• Space nodes — Don't crowd them together
• Align nodes — Use grid for neat layouts
• Group related nodes — Keep similar functions near each other

Naming

• Name your canvases descriptively
• Consider adding text nodes as "comments"

Simplicity

• Start simple, add complexity gradually
• Test each step before adding more
• Don't over-engineer—simpler is often better

Advanced Connection Techniques

Parallel Processing

Generate multiple variations simultaneously:

→ [Image Node (Model A)] →
[Text] ─┤                          ├→ Compare results
         → [Image Node (Model B)] →

Iterative Refinement

Chain AI text nodes to improve prompts:

[Text (basic)] → [Text (AI: enhance)] → [Text (AI: add details)] → [Image]

Conditional Workflows

Use different paths for different content:

[Upload (Portrait)] → [Face Enhancement] → [Upscaler]
[Upload (Product)] → [BG Remover] → [New Background] → [Upscaler]

Next Steps

• Running Workflows — Execute your connected workflows
• Creating Apps — Turn workflows into reusable Apps
• Multi-Step Workflows — Advanced workflow techniques