# \&rooms

Director Option! ([`&director`](/advanced-settings/director-parameters/director.md))

## Options

Example: `&rooms=room1,room2,room3`

<table><thead><tr><th width="161">Value</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>(string value)</td><td>adds the rooms to the guest transfer buttons to the director control bar (comma separated)</td><td></td></tr></tbody></table>

## Details

`&rooms` adds preset transfer destinations to the director control bar.

```
https://vdo.ninja/?director=ROOMID&rooms=ROOMID2,ROOMID3,ROOMID4
```

The link above adds `ROOMID2`, `ROOMID3`, and `ROOMID4` as transfer buttons.

<figure><img src="/files/H8IrWdNBRfHYYQ5chuyF" alt=""><figcaption></figcaption></figure>

Pressing any of these buttons will arm the transfer buttons beneath each caller with the chosen room name, allowing callers to be quickly moved from one room to another.

![](/files/BmWrHKnEDhNJCE5E79bP)

Arming can be disabled by clicking the room name again. If the current room is in the list it will be ignored.

## Access-control notes

`&rooms` only creates shortcut buttons. The destination room's own rules still apply.

* If the destination room has [`&requireapproval`](/advanced-settings/director-parameters/and-requireapproval.md), transferred guests wait for approval there.
* If the destination room has [`&roomcap`](/advanced-settings/director-parameters/and-roomcap.md) and is full, the transfer is rejected.
* If the guest link uses [`&queuetransfer`](/advanced-settings/guest-queuing-parameters/and-queuetransfer.md), the guest remains queued after transfer until activated.

{% hint style="warning" %}
If [`&cleanoutput`](/advanced-settings/design-parameters/cleanoutput.md) is enabled, rooms parameter is ignored.
{% endhint %}

## Related

{% content-ref url="/pages/-MZX1ErXldKpl6308TzB" %}
[\&room](/advanced-settings/setup-parameters/room.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MZHYK6N0TaNC3pa-8za" %}
[Rooms](/getting-started/rooms.md)
{% endcontent-ref %}

{% content-ref url="/pages/-M\_GN9YKWH8VJmAwHOek" %}
[How to transfer guests to other rooms](/guides/transfer-rooms.md)
{% endcontent-ref %}


---

# 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.vdo.ninja/advanced-settings/director-parameters/rooms.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.