# Custom Widgets

## Creating a Custom Widget

In order to create a **Custom Widget** follow the next steps :

* Click on the **Add** button and select **Widgets** in the opened list
* Set the **Name** of your widget on the right properties panel
* Add a **Tag** to group your custom widgets
* Add any **Parameters** you need
* Write your code in the central editor
* Save by clicking on the top right button **Save**

<figure><img src="/files/aMWkrlRV52rCBMVviz1O" alt=""><figcaption><p>Creation of a <strong>Custom Widget</strong></p></figcaption></figure>

## Use a Custom Widget

In order to use a **Custom Widget** :&#x20;

* Select the last tab in the **Toolbox** section
* Drag and drop your **Widget** where you want in the **Explorer**

<figure><img src="/files/NdNTmxO4Ac7Mm477pCAn" alt=""><figcaption><p>Example of use of a <strong>Custom Widget</strong></p></figcaption></figure>

{% hint style="info" %}
Custom Widget cannot be previewed but an insert with a different background color shows you the size and location of your widget
{% endhint %}

<figure><img src="/files/Ox1eSONhnNcpTe6SGNj4" alt="" width="241"><figcaption><p>Example of Application Preview in Goril.App</p></figcaption></figure>

{% hint style="info" %}
When you'll run your app in a real device or a simulator, you'll be able to see your widget in action !
{% endhint %}

<figure><img src="/files/mmBSTnpJYCXmkzuPlUUI" alt="" width="189"><figcaption><p>Custom Widget on simulator</p></figcaption></figure>


---

# 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.goril.app/main-pages/custom-code/custom-widgets.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.