---
title: Nodes
slug: nodes
docTags: 
createdAt: 2026-01-25T15:13:31.023Z
---

## Overview

Nodes are the building blocks of every workflow in Floyo. Each node performs a specific task, and you connect them together to create complete AI generation pipelines.

***

## What Are Nodes?

Each node does a specific job: loading a model, generating an image, adjusting a parameter, or passing data along. You connect nodes together to define how your workflow runs, step by step.

![](https://api.archbee.com/api/optimize/1hT0XoAHMhU4co8ZZjygd/baXfAWKY9U1wH4hqkW58b_image.png)

| Component      | Location   | Description                |
| -------------- | ---------- | -------------------------- |
| **Inputs**     | Left side  | Where data enters the node |
| **Outputs**    | Right side | Where processed data exits |
| **Parameters** | Node body  | Settings you can adjust    |

Some nodes are interactive, letting you upload a file or view a preview directly in the workflow.

***

## Node States

Nodes update their status as the workflow runs. You can see the current state by the colored border around each node.

![](https://images.archbee.com/Ix6MAQhJVD3YU-KVJRd4T-gJP5jLXS11toHWAyetEbD-20250829-190226.jpg?format=webp)

| State       | Border Color | Description                                            |
| ----------- | ------------ | ------------------------------------------------------ |
| **Normal**  | Default      | Node is idle, ready to process                         |
| **Running** | Green        | Node is currently processing                           |
| **Error**   | Red          | Something went wrong (missing input or bad connection) |
| **Missing** | Red outline  | Node is not installed or has missing dependencies      |

***

## Connections

To build a workflow, you connect the output of one node to the input of another. This tells Floyo how data should flow through your workflow.

![](https://www.gitbook.com/cdn-cgi/image/dpr=2,width=760,onerror=redirect,format=auto/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FdWW53gytWVkX6EU0Suex%252Fuploads%252F4J8y1fB3aj73XKOQ8Gsp%252FScreenshot%25202025-08-07%2520183613.png%3Falt%3Dmedia%26token%3Ddbf3eac2-ede9-40f0-aefd-9f3ad20a6262)

### Making Connections

1. Click on an output slot (right side of a node)
2. Drag to an input slot (left side of another node)
3. Release to create the connection

Only compatible inputs and outputs can connect. The color tells you whether two nodes can connect. If they're not compatible, the connection won't work.

Connections are drawn as lines between nodes, giving you a clear visual map of how your workflow is structured.

***

## Connection Color Codes

Every connection between nodes has a color that indicates what kind of data is flowing through the workflow. Learning the colors helps you instantly read and understand any workflow.

| Color      | Data Type    | Description                                                                                                |
| ---------- | ------------ | ---------------------------------------------------------------------------------------------------------- |
| **Yellow** | CLIP         | Converts your text into "AI language" that the model can understand                                        |
| **Red**    | VAE          | Acts like a portal between the AI world and visible image; decodes/encodes between pixels and latent space |
| **Blue**   | RGB Image    | Standard images in pixel space; what you see when you export or preview                                    |
| **Pink**   | Latent Space | Images in their compressed "AI-native" form; this is where the magic happens                               |
| **Orange** | Conditioning | Control data like pose, depth maps, or segmentation; guides generation without changing your prompt        |
| **Green**  | String       | Basic text inputs like filenames, folder paths, or simple values                                           |
| **Purple** | AI Model     | Your actual model file: diffusion models, checkpoints, LoRAs, or other trained weights                     |
| **Teal**   | ControlNet   | Used specifically for sending ControlNet data through your workflow                                        |

:::BlockQuote
**💡 Tip:** Each color gives you a clue about what's happening in your workflow. If you see a purple line, you know a model is being loaded. Pink lines mean latent images are being processed.
:::

***

## Tips & Best Practices

- **Follow the flow:** Arrange nodes left-to-right following the data flow for easier reading
- **Check colors:** Use connection colors to quickly understand what data is moving where
- **Watch for red:** Red borders or outlines indicate errors or missing nodes that need attention
- **Hover for info:** Hover over any node to see tooltips about its inputs and outputs

***

## Related Documentation

- [Adding Nodes](https://docs.floyo.ai/adding-nodes)
- [Node Settings](https://docs.floyo.ai/node-settings)
- [Core Nodes vs Custom Nodes](https://docs.floyo.ai/core-nodes-vs-custom-nodes)
- [Canvas Overview](https://docs.floyo.ai/canvas-overview)