Singularity/Library/PackageCache/com.unity.visualscripting@1.8.0/Documentation~/vs-nesting-subgraph-node.md

# Subgraph node

Use a Subgraph node to reference and trigger another Script Graph's logic from inside a parent Script Graph. 

![An image of the Graph window that displays a new Subgraph node created from an existing Script Graph added to another Script Graph file](images/vs-existing-graph-example-subgraph.png)

For more information on Subgraphs, see [Subgraphs and State Units](vs-nesting-subgraphs-state-units.md). For more information on Script Graphs, see [Graphs](vs-graph-types.md).

## Fuzzy finder category 

The Subgraph node is in the **Nesting** category in the fuzzy finder. 

You can go to the **Graphs** category and select any Script Graph to create a Subgraph node. For more information on how to create a Subgraph, see [Add a Subgraph to a Script Graph](vs-nesting-add-subgraph.md).

## Available ports 

By default, a Subgraph node has no ports.

Use the [Graph Inspector](vs-interface-overview.md#the-graph-inspector) to specify the following on a Script Graph: 

- Trigger Inputs. 
- Trigger Outputs. 
- Data Inputs.
- Data Outputs.

These determine the type and number of ports available on its Subgraph node. For more information on how to define ports on a Script Graph, see [Add a Trigger or Data port to a Script Graph](vs-nesting-add-triggers-data-graph.md).

| **Port type**      | **Description**       |
| :-------------     | :-------------------- |
| **Trigger Input**  | Adds a control input port to the Subgraph node for the Script Graph. Use a Trigger Input to choose which node or nodes from a parent graph triggers Visual Scripting to run the logic in the Subgraph. |
| **Trigger Output** | Adds a control output port to the Subgraph node for the Script Graph. Use a Trigger Output to choose which node or nodes Visual Scripting triggers after the logic contained in the Subgraph finishes. |
| **Data Input**     | Adds a data input port to the Subgraph node for the Script Graph. Use a Data Input to receive data from a parent graph. |
| **Data Output**    | Adds a data output port to the Subgraph node for the Script Graph. Use a Data Output to send data back to a parent graph. |

## Example graph usage

> [!TIP]
> A Subgraph node can use a new blank Script Graph or an existing Script Graph from a project. For more information, see [Add a Subgraph to a Script Graph](vs-nesting-add-subgraph.md).

In the following example, the Subgraph node **Character Move** references a graph that makes a GameObject move based on a user's input. It has the following: 

- One Trigger Input port.
- One Trigger Output port. 
- Three Data Input ports.
- One Data Output port. 

After every Update Event in the application, the **Character Move** Subgraph node triggers and takes the X, Y, and Z coordinates of the current GameObject's Transform component. The Subgraph node then outputs a new Vector 3 value, which the parent graph assigns to the current GameObject with a Transform Set Position node.   

![An image of the Graph window. The Output Trigger port on an On Update Event node connects to the Input Trigger port on a Subgraph node called Character Move. A Transform Get Position node gets the position of the current GameObject's transform in a Vector 3. The Transform Get Position node connects its Vector 3 output port to a Vector 3 Get X, Vector 3 Get Y, and Vector 3 Get Z node. The Get X, Get Y, and Get Z nodes connect to the X, Y, and Z data input ports on the Character Move Subgraph node, respectively. The Character Move Subgraph node's Output Trigger port connects to the Input Trigger on a Transform Set Position node, set to the current GameObject's transform. The Character Move Subgraph connects its Vector 3 output port to the Vector 3 input port on the Set Position node.](images/vs-subgraph-node-use-example.png)

The Subgraph node reduces the number of nodes in the parent graph. 

> [!TIP]
> To see the Script Graph attached to the Subgraph node in this example, see either [Input node](vs-nesting-input-node.md) or [Output node](vs-nesting-output-node.md).

## Related nodes 

Use a Subgraph node with the following nodes:

- [Input node](vs-nesting-input-node.md)
- [Output node](vs-nesting-output-node.md)