# Visual Editor

The Visual Editor is a drag-and-drop interface for building device logic without writing code. Built on [Blockly](https://developers.google.com/blockly), it provides an intuitive way to create scripts by connecting visual blocks that represent programming concepts.

Behind the scenes, the Visual Editor automatically translates your block arrangements into [UniotLisp](/advanced/uniot-lisp.md) code. This approach makes IoT development accessible to beginners while remaining efficient for experienced developers who want to prototype quickly. Focus on application logic instead of syntax details.

## How It Works

1. **Drag blocks** from the toolbox into your workspace
2. **Connect blocks** together to build logic - blocks snap together when they're compatible
3. **Configure blocks** by filling in values, selecting options, or creating variables
4. **Test in the emulator** to verify behavior
5. **Compile to UniotLisp** when ready to deploy or view the generated code

The Visual Editor handles:

* **Hardware interactions** - Read sensors, control actuators, and manage device I/O with Primitive blocks
* **MQTT communications** - Handle events, access payloads, and publish messages
* **Program logic** - Conditions, loops, variables, functions, and data manipulation

## Block Categories

The Visual Editor organizes blocks into categories by function. Each category contains blocks designed for specific purposes:

* [**Special**](/platform/sandbox/visual-editor/special.md): Provides blocks for controlling the script execution flow and interacting with external MQTT events.
* [**Logic**](/platform/sandbox/visual-editor/logic.md): Includes blocks for boolean operations, comparisons, and conditional statements to control the flow of your scripts.
* [**Math**](/platform/sandbox/visual-editor/math.md): Provides blocks for arithmetic, random number generation, and advanced mathematical functions.
* [**Loops**](/platform/sandbox/visual-editor/loops.md): Enables repeating sequences of instructions based on conditions or specific counts.
* [**Text**](/platform/sandbox/visual-editor/text.md): Contains blocks for creating, manipulating, and outputting text strings in your scripts.
* [**Variables**](/platform/sandbox/visual-editor/variables.md): Allows you to store, retrieve, and modify values using named variables in your scripts.
* [**Functions**](/platform/sandbox/visual-editor/functions.md): Lets you define reusable blocks of code with optional parameters and return values.
* [**Primitives**](/platform/sandbox/visual-editor/primitives.md): Includes blocks for direct hardware interactions, such as reading sensor data or controlling actuators.


---

# 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.uniot.io/platform/sandbox/visual-editor.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.