# \&widget

General Option! / Director Option! ([`&director`](https://docs.vdo.ninja/advanced-settings/director-parameters/director), [`&push`](https://docs.vdo.ninja/advanced-settings/setup-parameters/push), [`&room`](https://docs.vdo.ninja/advanced-settings/setup-parameters/room), [`&view`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/view), [`&scene`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/scene))

## Options

Example: `&widget=https%3A%2F%2Fwww.youtube.com%2Flive_chat%3Fis_popout%3D1%26v%3DORBwkXsUNEs`

<table><thead><tr><th width="208">Value</th><th>Description</th></tr></thead><tbody><tr><td>(URLComponent-encoded URL value)</td><td>load a side-bar with that page as an IFRAME embed</td></tr></tbody></table>

## Details

`&widget` lets you pass a URLComponent-encoded URL value. It will load a side-bar with that page as an IFrame embed, with support for YouTube/Twitch specifically added.

This was designed for Twitch / YouTube / [Social Stream chat](https://docs.vdo.ninja/steves-helper-apps/social-stream-ninja), but could in theory work with any CORS-friendly site, such as a third-party web tool.

The director of a room also has the option to enable/disable the widget function for everyone in the room via the room settings menu.

You can encode the URL here:\
<https://www.urlencoder.org/>

### Changing the width of the widget sidebar

**\&widgetwidth** can be used to set the width of the widget sidebar, as a percentile value.

* eg: `&widgetwidth=30`
* the max width is 50%, with the default already at 25%

### Considerations

* not all domains allow themselves to be embedded into VDO.Ninja
* you cannot use \&css or \&js in conjunction with \&widget, for security purposes

<figure><img src="https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2FNGRFwc6s2YOylYc0XLRA%2Fimage.png?alt=media&#x26;token=4464efaa-f493-4005-9cb9-34eb82bba1bc" alt=""><figcaption></figcaption></figure>

If the director uses `&widget`, it will auto sync that with all guests as they connect. I'll try to find ways to make it easier to resize/minimize in the future.

{% hint style="warning" %}
Widgets and IFrames will fail to load if inserting custom CSS into VDO.Ninja using \&css or \&base64css.  This is done for user security in mind.
{% endhint %}

## Related

{% content-ref url="../buttons-and-control-bar-parameters/chatbutton" %}
[chatbutton](https://docs.vdo.ninja/advanced-settings/buttons-and-control-bar-parameters/chatbutton)
{% endcontent-ref %}

{% content-ref url="../../steves-helper-apps/social-stream-ninja" %}
[social-stream-ninja](https://docs.vdo.ninja/steves-helper-apps/social-stream-ninja)
{% endcontent-ref %}