# \&requireapproval

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

## Details

`&requireapproval` enables server-side room admission approval for a claimed room.

When enabled, guests do not auto-join the room. They are placed in a pending state until the active room director approves or denies them.

This is different from [`&queue`](/advanced-settings/guest-queuing-parameters/queue.md). Queue mode is a guest workflow after the guest has reached the room flow. `&requireapproval` is a handshake-server admission check tied to the live director claim.

## Example

Director link:

```
https://vdo.ninja/?director=MyRoom&requireapproval
```

Guest link:

```
https://vdo.ninja/?room=MyRoom
```

To show the director a modal popup for each pending request, add [`&approvepopup`](/advanced-settings/director-parameters/and-approvepopup.md):

```
https://vdo.ninja/?director=MyRoom&requireapproval&approvepopup
```

## Behavior notes

* Guests waiting for approval see a pending/waiting message.
* Directors see pending join requests and can approve or deny them.
* Pending requests are scoped to the room, not to the director's browser session, so a director reload does not orphan them.
* If the director is not present, new guests are not blocked by that director's live approval setting.
* If a director claims or reclaims the room, pending guests are re-evaluated against the director's current admission settings.
* Matching [`&roomkey`](/advanced-settings/director-parameters/and-roomkey.md) values can bypass manual approval.
* [`&roomcap`](/advanced-settings/director-parameters/and-roomcap.md) can be combined with approval to limit the number of admitted and pending guests.

## Transfers

If a guest is transferred into a destination room that also uses `&requireapproval`, the transferred guest remains pending in the destination room until that destination room's director approves them.

If the pending transferred guest disconnects before approval, they may need to rejoin from the original invite flow.

## Notifications

`&requireapproval` does not automatically enable sounds or system notifications.

Use [`&approvepopup`](/advanced-settings/director-parameters/and-approvepopup.md) for a modal popup. Add [`&notify`](/advanced-settings/settings-parameters/and-notify.md) or `&beep` for audio alerts.

## Related

{% content-ref url="/pages/0pvG7wPli92vGYlyP3hH" %}
[\&approvepopup](/advanced-settings/director-parameters/and-approvepopup.md)
{% endcontent-ref %}

{% content-ref url="/pages/FcWXWvhwDS2DwO5K6O3q" %}
[\&roomcap](/advanced-settings/director-parameters/and-roomcap.md)
{% endcontent-ref %}

{% content-ref url="/pages/Ooi4zYfZocafbY1ydL3R" %}
[\&roomkey](/advanced-settings/director-parameters/and-roomkey.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/and-requireapproval.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.