# Get Objects By Tag

## Overview

![The Get Objects By Tag Node.](https://2628349686-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwnv17cpjDin2deSlOz0z%2Fuploads%2Fgit-blob-3dbcffd3390261404457ea5b4f7414d4ddabda25%2Fgetobjectsbytagupdatedimage.png?alt=media)

The **Get Objects By Tag Nodes** returns an **Array** of all **Objects**, specifically their **IDs**, which are associated with the given *tag* and fall under the *subtree* of a given **Object**. If no **Object** is given as input, it defaults to the **Root Object**, thus performing the search on the whole **Scene**.

To learn more about the **Root Object** and **Scene** structure, click [here.](https://docs.incari.com/incari-studio/2023.1/objects-and-types/scene-objects#structure-in-a-scene)

[**Scope**](https://docs.incari.com/incari-studio/2023.1/overview#scopes): **Scene**, **Function**, **Prefab**.

## Attributes

![The Get Objects By Tag Node Attributes.](https://2628349686-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwnv17cpjDin2deSlOz0z%2Fuploads%2Fgit-blob-cf6942802ad41408ffd8a52fcb43992707375966%2Fget-objects-by-tag-attri2.png?alt=media)

### Input

| Attribute | Type       | Description                                                            |
| --------- | ---------- | ---------------------------------------------------------------------- |
| `Tag`     | **String** | The *tag* of interest, if one is not provided in the **Input Socket**. |

## Inputs

| Input             | Type         | Description                                                                                                                                |
| ----------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| *Pulse Input* (►) | **Pulse**    | A standard **Input Pulse**, to trigger the execution of the **Node**.                                                                      |
| `Object ID`       | **ObjectID** | The *root* **Object** of the *subtree* in which the search will be performed. The default, if nothing is received, is the **Root Object**. |
| `Tag`             | **String**   | The *tag* of interest.                                                                                                                     |

## Outputs

| Output             | Type         | Description                                                                                                                            |
| ------------------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| *Pulse Output* (►) | **Pulse**    | A standard **Output Pulse**, to move onto the next **Node** along the **Logic Branch**, once this **Node** has finished its execution. |
| `Object IDs`       | **ObjectID** | An **Array** of all the **Object IDs** with the associated *tag*.                                                                      |

## See Also

* [**Add Tag**](https://docs.incari.com/incari-studio/2023.1/toolbox/incari/object/add-tag)
* [**Remove Tag**](https://docs.incari.com/incari-studio/2023.1/toolbox/incari/object/remove-tag)
* [**Get Tag**](https://docs.incari.com/incari-studio/2023.1/toolbox/incari/object/get-tag)