.. _doc_scene_unique_nodes:

Scene Unique Nodes
==================

Introduction
------------

There are times in a project where a node needs to be called
from a script. However, its position in the tree might change
over time as adjustments are made to a scene, such as a
button in a UI scene.

In situations like this, a node can be turned into a scene
unique node to avoid having to update a script every time
its path is changed.

Creating and using them
-----------------------

In the Scene tree dock, right-click on a node and select
**Access as Scene Unique Name** in the context menu.

.. image:: img/unique_name.png

After checking this, the node will now have a percent symbol (**%**) next
to its name in the scene tree:

.. image:: img/percent.png

To use a unique node in a script, use the ``%`` symbol and the node's
name in the path for ``get_node()``. For example:

.. tabs::
 .. code-tab:: gdscript GDScript

    get_node("%RedButton").text = "Hello"