# \&bgimage

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), [`&solo`](https://docs.vdo.ninja/advanced-settings/mixer-scene-parameters/and-solo))

## Aliases

* `&bgimg`
* `&avatarimg`

## Options

Example: `&bgimage=https%3A%2F%2Fvdo.ninja%2Fmedia%2Fold_icon.png`

<table><thead><tr><th width="371">Value</th><th>Description</th></tr></thead><tbody><tr><td>(Encoded URL)</td><td>URL or base64 data image/svg</td></tr></tbody></table>

## Details

`&bgimage` can be used to set the default image avatar, when using [`&style=0`](https://docs.vdo.ninja/advanced-settings/design-parameters/style) or [`&style=6`](https://docs.vdo.ninja/advanced-settings/design-parameters/style). This only impacts what the person with the parameter added sees and must be either a URL or a base64 data image/svg. URL-encoded values.

[`https://vdo.ninja/?push=aSmexM6&style=0&vd=0&webcam&bgimage=https%3A%2F%2Fvdo.ninja%2Fmedia%2Fold_icon.png`](https://vdo.ninja/?push=aSmexM6\&style=0\&vd=0\&webcam\&bgimage=https%3A%2F%2Fvdo.ninja%2Fmedia%2Fold_icon.png)

![](https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2F9TcX8TMvwepfyExlrGC8%2Fimage.png?alt=media\&token=02d5b88f-8ff7-4632-a06e-e39877193b0e)

You can encode your URL here:\
<https://www.urlencoder.org/>

If you want to change the background image / avatar on the sender's side for all viewers, use [`&avatar`](https://docs.vdo.ninja/advanced-settings/video-parameters/and-avatar).

## `&bgimage2` and `&bgimage3`

`&bgimage2` and `&bgimage3` work in conjunction with the existing `&bgimage` parameter. You pass an URL-encoded image URL to each, and when a guest speaks, it will switch their background image between the 3 possible images, based on their loudness.

eg:

```
vdo.ninja/alpha/?view=stream2,stream2&avatarimg=./media/avatar1.png&avatarimg2=./media/avatar2.png&avatarimg3=./media/avatar3.png
```

I've included some hand-drawn avatar sample images to test with; they are the default values for `&bgimage`, `&bgimage2`, and `&bgimage3`.

The images will only show when there is no active video and is essentially the same as using [`&meterstyle=4`](https://docs.vdo.ninja/advanced-settings/design-parameters/meterstyle) with some custom CSS to specify the behaviour, but it is not stream ID specific however.

## Related

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

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

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

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