docs.unity3d.com
  • Manual
  • Scripting API
  • Changelog
  • License
Show / Hide Table of Contents
  • About Visual Scripting
    • Configure project settings
      • Add or remove available nodes
      • Add or remove types
      • Create or restore a backup
    • Choose a control scheme
    • Configure your preferences
    • Update Visual Scripting
    • Version control systems
    • Use Visual Scripting with Unity Cloud Build
  • Basic concepts in Visual Scripting
    • The interface
    • Nodes
    • Graphs
      • Subgraphs and State Units
      • Transitions
    • Script Machines and State Machines
    • Object types
      • Custom types
    • Variables
  • Develop application logic with Script Graphs
    • Create a new graph file
      • Create a new blank graph with the Project window
      • Create a new unassigned graph with the empty graph creation flow
      • Create and assign a graph to an existing GameObject
      • Create and assign a graph to a new GameObject
      • Create a graph on a Script Machine or State Machine
    • Attach a graph file to a Script Machine or State Machine
    • Open a graph file
      • Add a node to a Script Graph
      • Connect nodes in a Script Graph
      • Create and add a variable to a Script Graph
      • Create node groups
      • Add comments to a graph
    • Add a Subgraph to a Script Graph
      • Add a Trigger or Data port to a Script Graph
    • Add a State Unit to a Script Graph
    • Custom Events
      • Add a Custom Event node
      • Add a Trigger Custom Event node
    • Capture user input in an application
      • Capture input using the Input Manager
      • Add and configure a Player Input component
      • Capture input using the Input System package
    • Use relations to debug
      • Predictive and live debugging
      • Working with debug messages
    • Live edit
      • Live edit during runtime
  • Develop logic transitions with state graphs
    • Create a new state
    • Create a transition between states
  • Advanced customization and development
    • Refactor a C# script with Visual Scripting
      • Add the RenamedFrom attribute to a C# script
    • Custom C# nodes
      • Create a new simple Custom C# node
      • Add ports to your Custom C# node
      • Add logic to your Custom C# node
      • Add relations to your Custom C# node
      • Add documentation to your Custom C# node
      • Custom C# node attributes reference
    • Create a Custom Scripting Event node
      • Create a Custom Scripting Event Sender node
      • Trigger a Custom Scripting Event from a C# script
      • Listen to a Custom Scripting Event from a C# script
    • Use a custom type
      • Add the Inspectable attribute to a custom type
      • Create a custom PropertyDrawer for a custom type
  • Node reference
    • This node
    • Control node
    • Time node
    • Events
      • Event nodes
      • Input Event nodes
        • On Input System Event Button
        • On Input System Event Float
        • On Input System Event Vector 2
        • On Button Input
        • On Keyboard Input
        • On Mouse Down
        • On Mouse Drag
        • On Mouse Enter
        • On Mouse Exit
        • On Mouse Input
        • On Mouse Over
        • On Mouse Up As Button
        • On Mouse Up
    • Variable node
    • Nulls node
    • Formula node
    • Nesting
      • Input node
      • Output node
      • State Unit node
      • Subgraph node
    • Script graph nodes
    • State graph nodes
  • Developer's guide
  • Known Issues

Create node groups

You can organize the nodes in your Script Graphs and State Graphs with node groups.

An image of the Graph window. The Graph Inspector is open, and a group named "Compare gold" is selected. The group is set to the default black color, doesn't have a comment, and contains a Set Variable node that retrieves the value of the Gold Saved variable, a Comparison node, and an Integer node with a value of 5.

Create a new group

To create a new group:

  1. Open the graph where you want to create a new group.

  2. In an empty area of the Graph Editor, Ctrl+click (macOS: Cmd+click) and drag to create a selection.

  3. Release the mouse to create the group.

After you create a group, you can:

  • Change the group name
  • Add a comment to the group
  • Change the color of the group
  • Resize the group
  • Move the group

Change a group name

To change the name of the group in your graph:

  1. In the group header, click Group.

  2. Enter a new name for the group.

  3. Press Enter to save your changes.

Add a comment to a group

To add a comment to a group in a graph:

  1. Select the group where you want to add a comment.

  2. Open the Graph Inspector.

  3. In the (Comment) field in the Graph Inspector, enter comments or information about the group.

Note

Group comments are only visible in the Graph Inspector. To add comments to a graph that are always visible, use a Sticky Note.

Change the color of a group

To change the color of a group in a graph:

  1. Select the group you want to edit.

  2. Open the Graph Inspector.

  3. In the Graph Inspector, select the Color field.

  4. Select a new color for your group through one of the following methods:

    • Use the color picker.
    • Use the sliders or RGBA value fields.
    • Enter a hexadecimal color value.
    • Select the eyedropper icon and select a color from anywhere on your screen.

Resize a group

To resize a group in a graph:

  1. Click and drag from any edge or corner on the group.

Move a group

To move a group and its nodes:

  1. Click and drag the group's header to a new location in the Graph Editor.
Note

You can also move a group without moving any of the nodes inside, but the required input changes based on your chosen control scheme. For more information, see Choose a control scheme

Next steps

After you've created a node group, you can add nodes to your Script Graph, create and add variables, or add a Subgraph.

You can also add a Sticky Note to add comments to a graph.

In This Article
Back to top
Copyright © 2025 Unity Technologies — Trademarks and terms of use
  • Legal
  • Privacy Policy
  • Cookie Policy
  • Do Not Sell or Share My Personal Information