# Add Tag

## Overview

![The Add Tag Node.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-d80d9ec77cda5e3ea8347ac05082b6f4a555b1d4%2Faddtagnode20241.png?alt=media)

The **Add Tag Node** attaches a *tag* to an **Object**. This *tag* acts as *metadata* and can be used later to identify many **Objects** by a shared *tag*.

It is important to note that when a *tag* is added with the **Add Tag Node**, the *tag* is only added once executed in the **Incari Player** and does not interact in any way with the *tags* added in the `Attributes` of an **Object** in **Incari Studio**. For example, this **Node** could be used for an **Object** created on runtime.

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

## Attributes

![The Add Tag Node Attributes.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-f4a712f8395d662a30c76575e54e4eb7869bd56a%2Faddtagattributes.png?alt=media)

### Object

| Attribute | Type         | Description                                                                                     |
| --------- | ------------ | ----------------------------------------------------------------------------------------------- |
| `Object`  | **ObjectID** | The **Object** that the *tag* will be added to, if one is not provided in the **Input Socket**. |

### Input

| Attribute | Type       | Description                                                                                       |
| --------- | ---------- | ------------------------------------------------------------------------------------------------- |
| `Tag`     | **String** | The *tag* to be added to the selected **Object**, 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 **Object** that the *tag* will be added to.                       |
| `Tag`             | **String**   | The *tag* to be added to the selected **Object**.                     |

## 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. |

## See Also

* [**Remove Tag**](https://docs.incari.com/incari-studio/toolbox/incari/object/remove-tag)
* [**Get Objects By Tag**](https://docs.incari.com/incari-studio/toolbox/incari/object/get-objects-by-tag)
* [**Get Tag**](https://docs.incari.com/incari-studio/toolbox/incari/object/get-tag)
