UnityGame/Library/PackageCache/com.unity.visualscripting/Documentation~/vs-groups.md

Create node groups

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

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:

2. In the group header, click Group.

3. Enter a new name for the group.

4. 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.