Docs
Download

Data

Fixed values, text, lists, comparisons and enum items.

The Data nodes give values to other nodes: a number, a text, a list, whether two values are equal. They're in Add › Data, with the submenus Boolean, Input, List and String.

Value nodes

Most Data nodes have no flow sockets (the diamond-shaped ones), only data inputs and outputs. These value nodes don't run at a point in a flow. They compute their result where something uses it: connect a Float to a Print, and the number is written right into the Print's code.

Two things follow from this:

  • A value node computes again for every input it's connected to. A Random Value connected to two inputs gives two different numbers, and a Current Time connected twice reads the clock twice.
  • A value node can't remember anything. Create List makes a new, empty list every time it's used, so a List Append that adds to it adds to a list nobody sees again. To build up a list or a total, store it in a variable first. Lists shows how.

The nodes that change a list (List Append, List Sort, ...) and For Each (List) do have flow sockets: they run in a flow, like a Print.

Socket types

The color of a socket shows the type of value it carries.

TypeHolds
DataAny value. Gray, no field: an unconnected Data input is None
Blender DataBlender data: an object, a scene, a material, ...
StringText
BooleanTrue or False
FloatA decimal number
IntegerA whole number
Vector2 to 4 numbers, like a location
Color3 (RGB) or 4 (RGBA) numbers from 0 to 1
ListA list of values (square socket). Blender collections like bpy.data.objects connect to it too
IconA built-in icon or a custom one

You can connect most types to each other. The value is converted on the way:

From → toResult
Anything → StringThe value as text (str()). Blender data gives its name: an object becomes "Cube"
Anything → Booleanbool(): 0, empty text, empty lists and None are False, everything else True
Integer → FloatThe same number
Float → IntegerCut off to a whole number: 2.9 becomes 2
String → Float / IntegerThe number in the text, 0 if the text isn't a number
Float / Integer → Vector / ColorThe number in every component: 0.5 becomes (0.5, 0.5, 0.5)
Vector ↔ ColorThe first three components; a color gets alpha 1
Vector / Color / List → Float / IntegerThe first component
Single value → ListA list with that one value; a text becomes a list of its characters
Anything → DataUnchanged

Some connections can't work and show an error on the node: Blender data into a number, vector or color, or a plain value into a Blender Data input.

Nodes

Node
BooleanTrue or False
IntegerA whole number
FloatA decimal number
StringA text
VectorA vector with 2, 3 or 4 components
ColorAn RGB or RGBA color
NonePython's None, "no value"
Current TimeThe date and time as text, and as seconds
Add-on InfoYour add-on's name, version, module and folder
CompareWhether two values are equal, or which is bigger
Boolean MathAnd / Or of two booleans
Invert BooleanTrue becomes False and False becomes True
Switch DataOne of two values, depending on a condition
Format StringPuts values into a text at each {}
Combine StringsJoins texts with a separator
Join ListJoins the items of a list into one text
Split StringSplits a text into a list
Replace StringReplaces every occurrence of a text
Slice StringPart of a text by position
Change CaseUPPER, lower, Title Case, ...
Trim StringRemoves spaces at the start and end
Pad StringFills a text up to a length, e.g. 007
String LengthThe number of characters
Find in StringWhere a text appears, and how often
Substring In StringWhether a text contains, starts or ends with another
Create ListA list from its inputs
List Get ItemThe item at a position
List LengthThe number of items
List IndexThe position of an item
List ContainsWhether an item is in the list
List SliceA part of the list
List AppendAdds an item at the end
List InsertAdds an item at a position
List ExtendAdds all items of another list
List Set ItemReplaces the item at a position
List RemoveRemoves an item
List PopRemoves the item at a position and gives it
List ClearRemoves all items
List ReverseReverses the order
List SortSorts the items
For Each (List)Runs a flow once per item
Enum ItemOne entry of an enum property's dropdown

Numbers and vectors are calculated with the Math nodes.