View & accessibility
Thumbnails
Motion
Bforartists
5.1
Editors

Sidebar

The Geometry Node Editor is made of several areas.

18
 min read
Up to date for 
5.1
draft

Introduction

Introduction

The Geometry Node Editor is made of several areas. At the right side you will find the sidebar. Here you will find further options and settings for the Geometry Node Editor nodes and its tools.

Right Click menus

Right Click menus

You will open the usual right click menus when clicking with the right mouse at elements in the sidebar. Its content is in big parts self explaining.

The right click menus are explained in the chapter 6 Editors Introduction.

Group Tab

Group tab - Introduction

Group tab - Introduction
Group tab - Introduction

The Shader sidebar Group tab at the right side contains options and settings for node groups and socket input and output properties.

It is especially meant for the group nodes. Grpup Input and Group Output.

In the group sockets panel you can define what sockets the Group Input and Group Output node has.

Group tab - Introduction
Group tab - Introduction
Group tab - Introduction
Group tab - Introduction
Group tab - Introduction
Group tab - Introduction

Group Properties Panel

Name

Name

Change the name of the current node group. Type in a new name and hit enter.

Description

Change the description of the current node group. Type in a new name and hit

enter.

Color Tag

Color Tag

Changes the header color of the current node group.

EntryWhat it does
Node WidthThe width for newly created node groups. Value can range between 40 and 700 px. · Set default group node width: Sets the width based of the parent node group in the current context.
Show Manage PanelDisplay the manage panel when creating a modifier.
Usage subpanelModifier: The node group is used as a geometry modifier. This setting is only relevant for marked nodegroups as an asset. · Tool: The node group is used as a tool. This setting is only relevant for marked nodegroups as an asset.

Group Sockets Panel

Group Sockets Panel

Manage the input and output properties of the Group Input and Output nodes.

More than one input and output slot can be useful when you want to modify the shader in the node group in more than one way.

Group Socket List

List of available input and output sockets.

Note: The list can be sorted by dragging the items around. And you can rename them.

List

The list of input and output sockets.

Name

Name

Change the name of the current selected input socket by double clicking on the socket in the list. Type in a new name and hit enter.

New Item

New Item

Adds a new input sockets to the list.

EntryWhat it does
InputAdds a new input sockets to the list.
OutputAdds a new output socket to the list.
PanelAdds a new panel socket to the list.
Panel Toggle
Panel Toggle

Converts an active selected Boolean socket into a Panel Boolean.

When converting a boolean to a panel boolean, the parent panel of the Boolean socket will move to the panel header.

Panel Toggle subpanel
Panel Toggle subpanel

When adding a panel toggle to a panel then a subpanel appears.

EntryWhat it does
DefaultInput value used for unconnected sockets.
Hide in ModifierDon’t show the input value in the geometry nodes modifier interface.

Shape

Shape

What kind of higher order types are expected to flow through this socket.

EntryWhat it does
Duplicate ItemDuplicates the active socket.
Remove ItemRemoves the selected input socket from the list. Node tree interface specials

Move Item Up/Down

Move Item Up/Down

Moves the active item to the specified direction. You can move the active item up or down the list.

Note: You can also alternatively drag and drop the active item to re-order.

Inputs

Inputs

Inputs are characterized by the colored dot to the left. These are manifested in the Group Input node.

Outputs

Outputs

Outputs are characterized by the colored dot to the right. These are manifested in the Group Output node.

Group Sockets Panel

The group input sockets differs in functionality from the group outputs sockets. So you will get other content when you selct a group input node compared to the group output node.

Type

Type

What kind of node group input or output type it is.

Type
Type

Type Float

Description

Add a tooltip to the socket description.

Atrribute Domain
Atrribute Domain

The attribute domain used by the geometry nodes modifier to create an attribute output.

Default Attribute

The default attribute.

Subtype
Subtype

Subtype of the default value.

EntryWhat it does
DefaultThe default value for the socket.
MinThe minimum value for the socket. Note: This is only available for vector and float types.
MaxThe maximum value for the socket. Note: This is only available for vector and float types.
Optional labelHide the label if not needed.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.
Shape
Shape
Shape

The shape of the socket.

Type Integer

Type Integer
Type Integer
Description

Add a tooltip to the socket description.

Atrribute Domain
Atrribute Domain

The attribute domain used by the geometry nodes modifier to create an attribute output.

Default Attribute

The default attribute.

Subtype
Subtype

Subtype of the default value.

EntryWhat it does
DefaultThe default value for the socket.
MinThe minimum value for the socket. Note: This is only available for vector and float types.
MaxThe maximum value for the socket. Note: This is only available for vector and float types.
Default Input
Default Input

Input to use when the socket is unconnected.

EntryWhat it does
Optional labelHide the label if not needed.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.
Shape
Shape
Shape

The shape of the socket.

Type Boolean

Type Boolean
Type Boolean
Description

Add a tooltip to the socket description.

Atrribute Domain
Atrribute Domain

The attribute domain used by the geometry nodes modifier to create an attribute output.

EntryWhat it does
Default AttributeThe default attribute that is used by a geometry nodes modifier.
DefaultThe default value for the socket.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.
Layer SelectionTake grease pencil or layer group as selection field.
Shape
Shape
Shape

The shape of the socket.

Type Vector

Type Vector
Type Vector
Description

Add a tooltip to the socket description.

Atrribute Domain
Atrribute Domain

The attribute domain used by the geometry nodes modifier to create an attribute output.

Default Attribute

The default attribute that is used by a geometry nodes modifier.

Subtype
Subtype

What special math operation is required. The subtype menu allows you to define the socket type sliders and read-out.

EntryWhat it does
DimensionsHow much dimensions to calculate.
DefaultThe default vector. It changes, dependant of what dimensions you use.
Min / MaxMinimum value and maximum value.
Default Input
Default Input

Input to use when the socket is unconnected.

EntryWhat it does
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.
Shape
Shape
Shape

The shape of the socket.

Type Color

Type Color
Type Color
Description

Add a tooltip to the socket description.

Atrribute Domain
Atrribute Domain

The attribute domain used by the geometry nodes modifier to create an attribute output.

EntryWhat it does
Default AttributeThe default attribute that is used by a geometry nodes modifier.
DefaultThe default color for the socket.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.
Shape
Shape
Shape

The shape of the socket.

Type Rotation

Type Rotation
Type Rotation
Description

Add a tooltip to the socket description.

Atrribute Domain
Atrribute Domain

The attribute domain used by the geometry nodes modifier to create an attribute output.

EntryWhat it does
Default AttributeThe default attribute that is used by a geometry nodes modifier.
DefaultThe default rotation values
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.
Shape
Shape
Shape

The shape of the socket.

Type Matrix

Type Matrix
Type Matrix
Description

Add a tooltip to the socket description.

Atrribute Domain
Atrribute Domain

The attribute domain used by the geometry nodes modifier to create an attribute output.

Default Attribute

The default attribute that is used by a geometry nodes modifier.

Default Input
Default Input

Input to use when the socket is unconnected.

EntryWhat it does
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.
Shape
Shape
Shape

The shape of the socket.

Type String

Type String
Type String
Description

Add a tooltip to the socket description.

Subtype
Subtype

What special math operation is required. The subtype menu allows you to define the socket type sliders and read-out.

EntryWhat it does
DefaultThe default string.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.

Type Menu

Type Menu
Type Menu
EntryWhat it does
DescriptionAdd a tooltip to the socket description.
DefaultThe default menu.
ExpandedDraw the menu socket as an expanded drop down menu.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.
Shape
Shape
Shape

The shape of the socket.

Type Geometry

Type Geometry
Type Geometry
EntryWhat it does
DescriptionAdd a tooltip to the socket description.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.

Type Object

Type Object
Type Object
EntryWhat it does
DescriptionAdd a tooltip to the socket description.
DefaultThe default object.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.

Type Collection

Type Collection
Type Collection
EntryWhat it does
DescriptionAdd a tooltip to the socket description.
DefaultThe default collection.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.

Type Image

Type Image
Type Image
EntryWhat it does
DescriptionAdd a tooltip to the socket description.
DefaultThe default image.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.

Type Material

Type Material
Type Material
EntryWhat it does
DescriptionAdd a tooltip to the socket description.
DefaultThe default image.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.

Type Font

Type Font
Type Font
EntryWhat it does
DescriptionAdd a tooltip to the socket description.
DefaultThe default font.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.

Type Bundle

Type Bundle
Type Bundle
EntryWhat it does
DescriptionAdd a tooltip to the socket description.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.

Type Closure

Type Closure
Type Closure
EntryWhat it does
DescriptionAdd a tooltip to the socket description.
Optional LabelMake the label optional. This may resul tin the label being skipped in some cases.
Hide ValueHide the input value even when the socket is not connected.
Hide in ModifierDon’t show the value in the geometry nodes modifier interface.

Group Sockets Panel - Type Panel

Group Sockets Panel - Type Panel
Group Sockets Panel - Type Panel

TODO

Closed by default

Panel is closed by default on new nodes.

Panel Toggle

Panel Toggle

Note: The Panel Toggle properties are only for the Panel Boolean type of panels.

EntryWhat it does
DefaultThe default value for the boolean toggles.
Hide in ModifierHides the panel boolean toggle from the modifier stack.
Single ValueThe default value for the panel boolean toggle.

Animation Panel

Animation Panel

Animation panels are about the Animation Slots for scene wide animation clips.

EntryWhat it does
NewCreate a new action clip for the light, used in the Dopesheet Editor - Action Clip mode.
Action SelectorThis selector allows users to manage actions associated with a particle system, ensuring that the correct animation data is applied. · Fake User: Assigns a "fake user" to the action, preventing it from being automatically deleted when it is no longer in use. · Add: Make a copy of the current action, including all animation data. · Remove: Delete the selected action, removing it from the light source.

Node Tab

Node panel

Node panel

Name

Name

The name of the selected node. Read only.

Despite being read only, this text can be edited. But be careful, it will not change the name in the header of the node. And it does not snap back to the original name of the node when you remove the custom text.

Label

Label

Allows you to define a custom name for the selected node. This text does change the name in the header of the node.

Width and Location

Width and Location

Type exact numbers to size and place the selected node. Handy for keeping big node trees tidy and lined up.

EntryWhat it does
WidthHow wide the node is. Same as dragging its side edge.
LocationWhere the node sits in the editor, as X (left/right) and Y (up/down). Nodes inside a frame still use the position in the whole editor.

Warning Propagation

Warning Propagation

What kind of messages should be propagated from this node to the parent node.

Color

Color row

Give the node a color of its own, so parts of a big node tree are easy to tell apart. Tick Color and click the color field to pick one.

The two small buttons next to the color field help when you color many nodes.

Copy Color

Gives all selected nodes the same color as the active node. Select the nodes, make the one with the color you want active, then click the copy button.

Presets

Stores colors you like, so you can reuse them with one click. Presets are saved globally, so they work in your other files too.

Properties panel

Properties panel

Lists the properties of the node in editable form. And the inputs in text form.

Properties panel

Note that some nodes might not have all functionality in the node itself, but shows it in the properties panel instead. The bake node for example, shows the bake packed content just in the sidebar.

To keep the information together, we describe this functionality in the corresponding node chapters.

For the group input and group output options see chapter Group properties.

Tool Tab

Tool Tab

Tool Tab

Contains the settings of the currently active tool in the tool shelf.

In the node editor we don't have something special here. The tool related settings are explained in the tool shelf chapter.

View Tab

View Tab - Annotation Panel

View Tab - Annotation Panel
View Tab - Annotation Panel
View Tab - Annotation Panel
View Tab - Annotation Panel

View related settings. Which is in the node editor just the Annotations panel where you can manage the Annotation layers and materials.

When you don't have drawn an annotation yet then the panel just contains a New button.

Annotations prop

Annotations prop

Add, remove and rename new annotations.

Drop down box

A list of the available annotation layers.

EntryWhat it does
Edit BoxThe name of the current annotation. You can rename the annotation to your needs here.
Fake UserAssign a fake user to this annotation. Fake users is an odd concept to keep data in the scene even if it has no user somewhere. The fake user is then a dummy user so that the object is not deleted when saving the scene.
Add AnnotationAdd a new annotation.
Delete AnnotationDelete the annotation.

List of Annotation Strokes

List of Annotation Strokes
List of Annotation Strokes

Here you see your Annotation layers for the current Annotation. Every layer can have an own color.

At the right side you find buttons to sort them and to add and remove new Annotation layers.

You can change the color by clicking at the color field. A color dialog will pop up. You can rename annotation layers by double clicking at it.

The eye icon allows you to make it invisible And it has a search field.

EntryWhat it does
ThicknessThe thickness of the annotation stroke.
Frame Locked/UnlockedLock frame displayed by current layer. This toggles whether the active layer is the only one that can be edited.

Onion Skin

Onion Skin

Enable Onion Skinning.

Onion Skinning allows to show ghosts of the keyframes before and after the current frame. In this sub panel you can adjust the color of the onion skin frames.

With the numbers below the colors you can define how many frames before or after are displayed that way.

Add

Add Tab

Add Tab
Add Tab

Here you can find the same nodes than in the Add menu. Panels are more convenient to use. They stay open for example. It's your decision with what system you want to work.

We won't explain the content of the panels again. The single nodes are explained in the add menu chapter.

Usage

Click at one of the node buttons, then move the mouse into the viewport. The created node sticks at the mouse. Click again to release it.

Add tab - Display Panel

Add tab - Display Panel
Add tab - Display Panel

Icon Buttons

You can display the nodes in the panels either as text buttons or as pure icon buttons.

Relations Tab

Relations tab - Display Panel

Relations tab - Display Panel
Relations tab - Display Panel

Icon Buttons

Icon Buttons

You can display the nodes in the panels either as text buttons or as pure icon buttons.

Relations tab - Group Panel

Relations tab - Group Panel
Relations tab - Group Panel

Group Input

Group Input

Adds a group input node.

Group Output

Group Output

Adds a group output node.

Relations tab - Nodegroups Panel

Relations tab - Nodegroups Panel
Relations tab - Nodegroups Panel

When you create a node group, then this node group is listed here. And can be dragged from there for reuse too.

Relations tab - Layout Panel

Relations tab - Layout Panel
Relations tab - Layout Panel

These nodes helps organizing the node layout.

Frame

Frame

The Frame node allows you to drop nodes into a frame. This frame can be dragged around as a whole.

Adding and Removing Nodes

Adding and Removing Nodes
Adding and Removing Nodes

Nodes can be added by simply dropping them onto the frame. Or with the Join in New Frame menu item in the Node menu.

To remove a node from the frame use Remove from Frame.

Resizing Frame

When the Frame node is first placed in the node editor workspace you can resize it by dragging one of the edges.

Once a node is placed in the Frame, the Frame shrinks around the nodes. You cannot resize it anymore with handlers. Just by dragging around the nodes inside of the frame.

Resizing Frame

This behavior can be changed by disabling the Shrink option in the Item tab in the Properties panel. Then you can resize the frame again by dragging the edges.

Label and Color

You can change the name of a frame in the Node panel. And you can give it a custom color by checking the Color checkbox and adjusting the color then.

Reroute

Adds a reroute point that can be used to reroute connections. It allows just one input, but allows multiple output connections.

To quickly add a Reroute node into an existing connection, hold Shift and Right Mouse and drag the mouse to cut through the link. A new reroute node will be added.

Reroute
Reroute
Reroute

When you exceed a specific angle amount between the reroute nodes, then the node connection becomes a sharp corner, and not longer a Bezier like soft curve.

Move, Rotate, Scale

Move, Rotate, Scale

A normal node has a handler. The reroute dot not. You can't simply move it around with the mouse by clicking at the top area. It has none. You have to use the move, rotate and scale commands. They can be found in the View menu.