# \&orderby

Director Option! ([`&director`](https://docs.vdo.ninja/advanced-settings/director-parameters/director))

## Options

Example: `&orderby=label`

<table><thead><tr><th width="177">Value</th><th>Description</th></tr></thead><tbody><tr><td><code>label</code></td><td>will sort based on the display name (<a href="../setup-parameters/label"><code>&#x26;label</code></a>) of each video, if the label is set, instead of by stream ID.</td></tr><tr><td>(no value given)</td><td>orders guest's by their stream ID in the director's room</td></tr></tbody></table>

## Details

`&orderby` is a director's URL parameter. While the default ordering of guests in the director's room is by time of joining, if you use `&orderby` it instead orders by guest's stream ID. I'll be adding different ordering options later, but for now it's just by stream ID (case ignored; a to z, etc).

You can still manual reorder a guest, but when you shift someone up or down the list, they will be ignored by the ordering from there on. This order is different than the mix-order; this order is largely cosmetic and only impacts the MIDI mix order IDs really.

#### Update in [v23](https://docs.vdo.ninja/releases/v23 "mention")

I updated `&orderby` to work with non-director view links, such as with scenes or guests.

Previously `&orderby` only worked with the director's view to sort the positioning of control boxes, based on the *stream ID*, but now it can apply to the auto-mixer.

The *mix order*, or [`&order=N`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/order), of each guest takes priority over the name when sorting. By default all guests have a mix order of 0, mind you. You can change it dynamically as a guest, via the mix-order option in each guest's control box, or pre-assign it via URL with `&order=N` on the guest invite.

#### Sort by label

I also added `&orderby=label` as an option, which will sort based on the display name ([`&label`](https://docs.vdo.ninja/advanced-settings/setup-parameters/label)) of each video, if the label is set, instead of by stream ID.

This option doesn't apply to the director's view at the moment, but it does work when used with respect to the auto-mixer (guests/scenes).

The label sort ignores letter casing, while the default stream ID includes letter casing in the sorting logic.

## Related

{% content-ref url="../mixer-scene-parameters/order" %}
[order](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/order)
{% 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-orderby.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.