# \&label

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

* `&l`

## Options

Example: `&label=Steve`

| Value             | Description                                        |
| ----------------- | -------------------------------------------------- |
| (no value given)  | It will prompt the user for a Display Name on load |
| (string)          | Sets the label for the guest/browser tab           |
| `TITLEn\SUBTITLE` | [Multiple lines](#multiple-lines-on-alpha)         |

## Details

`&label` sets a display name label to the stream ID.

* Uses the label in OBS Studio if dragging the link into OBS Studio.
* Will change the name of the Browser tab to the Label specified.\
  ![](https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2FXN59LcFY0gVSFLVbTbPf%2Fimage.png?alt=media\&token=0b807cdb-3bcc-44f2-8556-f8eb9512793a)
* Shows up in the connection debug Stats window.\
  ![](https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2FY1LQN3ntzxmIWeOLeKuJ%2Fimage.png?alt=media\&token=304dffe9-fbdf-4b3f-8cc2-e8f57202c6c2)
* If left blank, it will prompt the user for a Display Name on load.\
  ![](https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2FiiQyf76Ubppu390e7WzT%2Fimage.png?alt=media\&token=a961c594-8156-464b-b9fe-a1724bae560d)
* You can use [`&showlabels`](https://docs.vdo.ninja/advanced-settings/design-parameters/showlabels) to show the labels in the video sources.

### Multiple lines

Until I figure out a better way of doing this, I've enabled a way to have a display name be on multiple-lines in VDO.Ninja.

`&label=DisplayNameHere\nSubtitleHere` Note the use of as a line break ie:

```
https://vdo.ninja/?label=Steve_Seguin\n(he/him)\nhttps://twitch.tv/vdoninja&push=JaAiVEH
https://vdo.ninja/?view=JaAiVEH&showlabels
```

So it's not super obvious how to do this currently, so I think the next goal will be to add the option to let a guest enter their own sub-title, etc, when joining, using dedicated input fields. But until then, I hope this still helps. You can stylize the sub-label within OBS's CSS section, targeting the following CSS, but please note I'll probably be tweaking the CSS/HTML as well in the future:

```
.video-label>span:nth-child(2) {
    font-size: 50%;
    display: block;
    text-align: center;
}
```

![](https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2F0yVv6VYvA3zZQjAI3XVu%2Fimage.png?alt=media\&token=edf0ae99-7ef2-4956-8136-50e8eebdd388)

## Related

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

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

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