Adding Nodes

Search and Add (Recommended)

  • Double-click on the canvas -> type in the search box
  • Click the node you want, or select it with the arrow keys and press Enter

Click the icon next to the search box to open the filters. You can narrow results by data type or by the custom node pack they come from.

There's no way around it: you just have to learn which nodes exist. Hang in there!!

Add from Menu

  • Right-click on the canvas -> Add Node -> find the node and click it

Add from Connectable Nodes

  • Drag from a pin and release on the canvas
  • A search box appears, already filtered by data type

Add from Connectable Nodes (Legacy)

  • Drag from a pin and release on the canvas while holding Shift
  • Pick from the list that appears (it only shows a limited number, so use Search if you can't find it)

Connecting Nodes

  • Drag from pin to pin
  • You don't have to hit the pin exactly: just drag onto the node and it snaps into place.

Changing Connections

  • Drag from pin to pin while holding Shift
  • If links are already connected, you can move them all to the new pin at once.

Manipulating Nodes

Selection and Movement

  • Select multiple: Shift or Ctrl + left-click
  • Box select: Ctrl + drag
  • Move: Drag the selection

Deletion

  • Select the node and press Delete
  • Or click 🗑️ in the Node Selection Toolbox

Copy & Paste

  • Regular copy: Ctrl + C -> Ctrl + V
  • Paste with connections kept: Ctrl + C -> Ctrl + Shift + V
  • Duplicate: Drag while holding Alt

Collapse

  • Click ⚫ at the top left of the node
  • While a node is collapsed, you can't connect or disconnect links.

Pinning (Fixing)

Locks the node in place so it can't be moved.

  • Select the node and press P

Reset Parameters

  • Right-click the node -> Fix node(recreate)

Node Info

Shows details about the node.

  • Click ℹ️ in the Node Selection Toolbox
  • You can see things like which Python file defines the node. Handy for debugging errors.

Changing Node Color

Changing node background colors to color-code them by role makes a workflow easier to read.

  • Click 🎨 (Color) in the Node Selection Toolbox and pick a color

Changing Node Title

Changes the node's display name (title).

  • Double-click the node -> type any name you like and press Enter

Reroute Node

Used to tidy up the wiring in a workflow.

  • Search for it and add it
  • Middle-click a point to add one

Dot Type Reroute

The Reroute node is a standalone node, but this one isn't a node at all: it just sets a point the link passes through.

  • Alt + Left Click a point on the link

Bypass and Mute

Bypass

Processing continues, skipping that node.

  • Select the node and press Ctrl + B
  • Click 🔀 in the Node Selection Toolbox

Mute

Processing stops at that node.

  • Select the node and press Ctrl + M
  • Or right-click -> Mode -> Never

The difference

  • Bypass: Treats the node as if "it wasn't there" and tries to connect the nodes before and after it directly.
  • Mute: Makes it "a dead end here".

In practice, mute isn't used much. Most people just bypass every node they're not using.

Converting to External Input

Turns an input field (widget) into a pin input so other nodes can pass it a value.

  • Convert: Hover next to a parameter that has no pin, and a connection point appears.
  • Revert: Disconnect the link, and it automatically goes back to a regular input field.

Primitive Node

An all-purpose node that can feed an input of any type. It changes dynamically to match whatever it's connected to.

Because it adapts to the type it's connected to, it can't be used together with reroute nodes.

These days, I recommend using nodes with a fixed type, such as int node, float node, and string node.

Double clicking a pin automatically connects a Primitive node matching that type.

Organizing Nodes

Select multiple nodes and click ⋮ in the Node Selection Toolbox.

  • Align Selected To: Lines up the selected nodes (top, left, and so on).
  • Distribute Nodes: Spaces the selected nodes evenly.