# \&background

General Option! ([`&push`](/advanced-settings/setup-parameters/push.md), [`&room`](/advanced-settings/setup-parameters/room.md), [`&view`](/advanced-settings/mixer-scene-parameters/view.md), [`&scene`](/advanced-settings/mixer-scene-parameters/scene.md), [`&solo`](/advanced-settings/mixer-scene-parameters/and-solo.md))

## Aliases

* `&appbg`

## Options

Example: `&background=./media/logo_cropped.png`

| Value         | Description                         |
| ------------- | ----------------------------------- |
| (encoded URL) | Changes the background of VDO.Ninja |

## Details

Accepts a URL-encoded image URL to make as the app's default background.

To test:\
[`https://vdo.ninja/?background=./media/logo_cropped.png`](https://vdo.ninja/?background=./media/logo_cropped.png)

The image will scale in size to cover the VDO.Ninja app's background. [`&chroma`](/advanced-settings/design-parameters/chroma.md) can still be used to set the background color, if using transparencies. There already exists [`&bgimage`](/advanced-settings/design-parameters/and-bgimage.md), which will set the default background image for videos; this however will set a background image for the entire page.

You can encode and decode a URL here:\
<https://www.urlencoder.org/>

<figure><img src="/files/66tvtfPlnJbWFVVAtjUo" alt=""><figcaption></figcaption></figure>

## Related

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

{% content-ref url="/pages/-MZHfj9aSfYk2RJf\_S4y" %}
[\&chroma](/advanced-settings/design-parameters/chroma.md)
{% endcontent-ref %}

{% content-ref url="/pages/QVr581oBYAXwbToiVTvS" %}
[\&waitimage](/advanced-settings/mixer-scene-parameters/and-waitimage.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/design-parameters/and-background.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.
