# Get Objects By Tag

## Overview

![The Get Objects By Tag Node.](/files/qxSK2fUG2I1fqkYvVAvP)

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.](/incari-studio/objects-and-types/scene-objects.md#structure-in-a-scene)

[**Scope**](/incari-studio/toolbox/overview.md#scopes): **Scene**, **Function**, **Prefab**.

## Attributes

![The Get Objects By Tag Node Attributes.](/files/UkWp9hzjcQiYU6OwAsme)

### 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**](/incari-studio/toolbox/incari/object/add-tag.md)
* [**Remove Tag**](/incari-studio/toolbox/incari/object/remove-tag.md)
* [**Get Tag**](/incari-studio/toolbox/incari/object/get-tag.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.incari.com/incari-studio/toolbox/incari/object/get-objects-by-tag.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.