# Toggle

The **Toggle** **Object** is a **2D GUI Object** that has two states: checked or unchecked. Its initial state and colors can be customized in the [**Attributes**](#attributes).

![Toggle.](/files/n8bFyNsa33IkDZIGTCjc)

![Toggle example.](/files/CyvIO3XCAsnRNV7L2TcT)

## Attributes

The **Object's** **Attributes** can be used to fully customize the **Object**. Explained below, they are:

* [**Transformation**](#transformation)
* [**Toggle**](#toggle)
* [**Style**](#style)
* [**Tag**](#tag)

### Transformation

![Transformation Attributes.](/files/5uiXjCATUiZRhpXw9M5V)

The `Transformation` **Attributes** deal with placement, rotation, and size in *XY* space. More information can be found [here](/incari-studio/objects-and-types/attributes/common-attributes/transformation.md).

### Toggle

![Toggle Attributes.](/files/vCYmcyRRVG3iyQNNmggo)

The `Toggle` **Attributes** provide crucial data for a **Toggle Object**.

* `Is checked` can be enabled or disabled. Enabled toggles it on and disabled toggles it off.

### Style

![Style Attributes.](/files/Y3DfvyBTpN6LCzr4iuGO)

The **Style Attributes** offer the user options to customize further visual aspects of the **Toggle**:

* `Handle Color` is the color of the **Toggle's** handle. It is the small circle which appears on the background of the **Toggle**.
* `Checked Color` is the color of the background when `Is checked` is enabled.
* `Unchecked Color` is the color of the background when `Is checked` is disabled.
* `CSS Classes` contain the *CSS* class names of the **Object**.
* `Stylesheet` contains the *CSS* stylesheet of the **Object**. This can override any stylesheet provided in the [**Project Settings**](/incari-studio/modules/project-settings/style.md) or a [**Scene2D**](/incari-studio/objects-and-types/project-objects/scene2d.md). To address these in the **Logic**, please refer to the [**Object 2D Nodes**](/incari-studio/toolbox/incari/object2d.md).

### Tag

![Tag Attributes.](/files/ly2k7Co6xC9D4aL93xjs)

This **Attribute** manages the *tags* for the **Toggle**. See more on *tags* [here.](/incari-studio/objects-and-types/attributes/common-attributes/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/objects-and-types/scene2d-objects/gui/toggle.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.