# \&groupview

General Option! ([`&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))

## Aliases

* `&viewgroup`
* `&gv`

## Options

Example: `&groupview=Groupname`

<table><thead><tr><th width="222.57142857142856">Value</th><th>Description</th></tr></thead><tbody><tr><td><code>1</code></td><td>adds the guest or director to group 1</td></tr><tr><td><code>2</code></td><td>adds the guest or director to group 2</td></tr><tr><td><code>3,4,5,6</code></td><td>adds the guest or director to group 3, 4, 5 and 6</td></tr><tr><td>(string)</td><td>creates/adds the guest or director to a custom group</td></tr></tbody></table>

## Details

`&groupview` is the same as [`&group`](https://docs.vdo.ninja/advanced-settings/setup-parameters/and-group), except it lets you see those groups without actually needing to join them with your mic/camera. (There's no button in the directors/guest view for this, since there isn't a need yet for that.)

You can change the view-only groups via the API (http/IFrame) or using the [Comms app](https://docs.vdo.ninja/steves-helper-apps/comms), which has been updated with buttons for this option. the HTTP documentation: <https://github.com/steveseguin/Companion-Ninja/blob/main/README.md#api-commands>

You can now use the HTTP/WSS API to both join and leave a group; not just toggle said state. Both the view-group function and regular group function.

## Related

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

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

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