# \&group

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

* `&groups`

## Options

Example: `&group=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

The idea is, you can put guests of a room into sub-groups. When added to a sub group, those guests will only be able to see and hear others in that same sub group.&#x20;

Guests can be assigned to multiple subgroups. Groups can be specified via the URL using `&group=1,5,6` or/and the director can dynamically assign sub-groups, as seen in the below image.&#x20;

![](https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2FOsaebu8YxO3WrjGwTgep%2Fimage.png?alt=media\&token=1fb207c6-9932-4685-bcbd-7ebe42f73625)

If not in a group, that guest will still see/hear everyone, regardless of which group they are in, even if a guest in another group may not be able to see/hear that guest back.

Scenes can be put into groups as well, via the URL group option, such `&group=3`, but the director will not be able to dynamically change which group a scene is in. Not yet at least.

Using this group function is an alternative to transfer rooms, however it's perhaps less secure, as a guest could just tinker with their URL parameters or just refresh their page to perhaps see everyone in the room again.

[`&groupaudio`](https://docs.vdo.ninja/advanced-settings/setup-parameters/and-groupaudio) can be used to enable audio in-between different groups, instead of audio being group-specific. Useful for blind-dating show formats or such.

### New in Version 22

Custom groups used by remote guests now show in the director's view, just like custom scenes do. If you use `&groups=group,test,vdo`, new group buttons will appear.\
![](https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2Fv3cbPOLVGjtPGxlyBw54%2Fimage.png?alt=media\&token=b9ad242a-1e77-413b-8971-84e7bc6eac6c)

With [`&groupmode`](https://docs.vdo.ninja/advanced-settings/setup-parameters/and-groupmode) added to your URL, when not assigned to a group, you don't hear or see anything. This also goes for remote participants who are not in a group - you will not see or hear them if they are not in a group, even if you also are not in a group.

## Related

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

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

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

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