# Find(string)

> Finds and returns a GameObject with the specified name or hierarchy path.

## Definition

* **Type:** Method
* **Namespace:** [UnityEngine](/engine/6000.0/script-reference/unityengine.md)
* **Assembly:** UnityEngine.CoreModule

```csharp
public static GameObject Find(string name)
```

### Parameters

**** (\[string]\(https\://learn.microsoft.com/dotnet/api/system.string)): The name or hierarchy path of the GameObject to find.

### Returns

| Type                                                                    | Description |
| ----------------------------------------------------------------------- | ----------- |
| [GameObject](/engine/6000.0/script-reference/unityengine/gameobject.md) |             |

### Remarks

Only returns active GameObjects. Returns `null` if no GameObject with `name` exists. If `name` contains a `/` character, it is treated as a path to the GameObject in the Hierarchy window. If there are multiple GameObjects with the same name, the recommended best practice is to not use this method.

If a path starts with `/`, the first object in the path must not have any parents in the Hierarchy view. Paths that don't start with a `/` can start from a child GameObject. For example, if there is a GameObject named Hand which is a child of Arm which is a child of Monster, you can find it with `/Monster/Arm/Hand` or `Arm/Hand` but not `/Arm/Hand`.

`GameObject.Find` causes significant performance degradation at scale and is not recommended for performance-critical code, especially in [MonoBehaviour.Update()](/engine/6000.0/script-reference/unityengine/monobehaviour/update.md). `Find` searches the entire scene and if the game is running with multiple scenes, it searches all of them. The search is linear, checking each GameObject one by one and, in the case of a path, traversing the hierarchy. The result is not cached automatically and every call performs the full search again.

The more GameObjects you have and the more frequently you call `GameObject.Find`, the greater the impact on your application's performance. Instead, cache the result in a member variable at startup, or use [GameObject.FindWithTag](/engine/6000.0/script-reference/unityengine/gameobject/findwithtag.md).

To find a child GameObject, it's often preferable to use [Transform.Find](/engine/6000.0/script-reference/unityengine/transform/find.md), which only searches the children of the specific transform rather than the whole scene.

```csharp
using UnityEngine;
using System.Collections;

// This returns the GameObject named Hand in one of the Scenes.

public class ExampleClass : MonoBehaviour
{
    public GameObject hand;

    void Example()
    {
        // This returns the GameObject named Hand.
        hand = GameObject.Find("Hand");

        // This returns the GameObject named Hand.
        // Hand must not have a parent in the Hierarchy view.
        hand = GameObject.Find("/Hand");

        // This returns the GameObject named Hand,
        // which is a child of Arm > Monster.
        // Monster must not have a parent in the Hierarchy view.
        hand = GameObject.Find("/Monster/Arm/Hand");

        // This returns the GameObject named Hand,
        // which is a child of Arm > Monster.
        // Monster can have a parent in the Hierarchy view.
        hand = GameObject.Find("Monster/Arm/Hand");
    }
}
```

`GameObject.Find` is useful for automatically connecting references to other objects at load time; for example, inside [MonoBehaviour.Awake()](/engine/6000.0/script-reference/unityengine/monobehaviour/awake.md) or [MonoBehaviour.Start()](/engine/6000.0/script-reference/unityengine/monobehaviour/start.md).

A common pattern is to assign a GameObject to a variable inside [MonoBehaviour.Start()](/engine/6000.0/script-reference/unityengine/monobehaviour/start.md), and use the variable in [MonoBehaviour.Update()](/engine/6000.0/script-reference/unityengine/monobehaviour/update.md).

```csharp
using UnityEngine;
using System.Collections;

// Find the GameObject named Hand and rotate it every frame

public class ExampleClass : MonoBehaviour
{
    private GameObject hand;

    void Start()
    {
        hand = GameObject.Find("/Monster/Arm/Hand");
    }

    void Update()
    {
        hand.transform.Rotate(0, 100 * Time.deltaTime, 0);
    }
}
```

Additional Resources: [GameObject.FindGameObjectsWithTag](/engine/6000.0/script-reference/unityengine/gameobject/findgameobjectswithtag.md)