# Additional Widget Options

Within the code generated by Airdesk, you can add extra widget handling options.  

Example of a code generated by Airdesk that is placed on the client's page:

```markup
 <script defer> 

      (function (a, i, r, d, e, s, k) { 

        a.airdesk = { settings: { cpid: "TEST-EXAMPLE" } }; 

        e = i.getElementsByTagName("head")[0]; 

        s = i.createElement("script"); 

        s.async = 1; 

        s.src = r + d; 

        e.appendChild(s); 

        a.$airdeskOnLoad = () => { 

          var {$airdesk} = a;

//Extra options are added below this line 

}; 

      })(window, document, "https://script.airdesk.ai/v1/", "air.js"); 

    </script> 
```

| Option                    | Explanation                                                                                                                                                                                                                                        |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| $airdesk.open()           | The widget will open the form automatically as soon as it's ready.                                                                                                                                                                                 |
| $airdesk.close()          | The widget closes the form.                                                                                                                                                                                                                        |
| $airdesk.language(CODE)   | <p>If the user doesn't have a language already saved.  <br>This option allows you to choose a starting language, instead of choosing the starting language depending on the browser's language.  Examples of CODE "en-GB", "pt-PT", "en-ES".  </p> |
| $airdesk.position(STRING) | Changes the initial positioning to a pre-effect.                                                                                                                                                                                                   |
| $airdesk.position('bl')   | Changes the widget's positioning to the lower left corner.                                                                                                                                                                                         |
| $airdesk.right(NUMBER)    | Replaces the initial positioning of the widget button on the right. The positioning is done on px basis.                                                                                                                                           |
| $airdesk.left(NUMBER)     | Replaces the initial positioning of the widget button on the left. The positioning is done on px basis.                                                                                                                                            |
| $airdesk.bottom(NUMBER)   | Replaces the initial positioning of the widget button vertically starting from below. The positioning is done on a px basis.                                                                                                                       |
| $airdesk.top(NUMBER)      | Replaces the initial positioning of the widget button vertically starting at the top. The positioning is done on a px basis.                                                                                                                       |
| $airdesk.hidden()         | Hide the page widget. It no longer allows to press the button and open the form.                                                                                                                                                                   |
| $airdesk.visible()        | Shows the widget that has been hidden.                                                                                                                                                                                                             |

{% hint style="info" %}
To use widget functions with javascript, these must always be called within a load event.&#x20;

window\.addEventListener ('load', function () {})
{% endhint %}

You can call up these options after initialization of the widget like for example make the widget, after loading on the page, automatically open the form as follows:&#x20;

```markup
 <script defer> 

      (function (a, i, r, d, e, s, k) { 

        a.airdesk = { settings: { cpid: "TEST-EXAMPLE" } }; 

        e = i.getElementsByTagName("head")[0]; 

        s = i.createElement("script"); 

        s.async = 1; 

        s.src = r + d; 

        e.appendChild(s); 

        a.$airdeskOnLoad = () => { 

          var {$airdesk} = a;

//Opções extra são adicionadas abaixo desta linha 

$airdesk.open() 

}; 

      })(window, document, "https://script.airdesk.ai/v1/", "air.js"); 

    </script> 
```

Or, it's also possible to call the options in the client's javascript after the widget is initialized, as follows:&#x20;

```markup
window.$airdesk.open(); 
```


---

# 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://en.docs.airdesk.ai/interface/administracao/espaco/opcoes-adicionais-do-widget.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.