# \&grid

Sender-Side Option! ([`&push`](https://docs.vdo.ninja/advanced-settings/setup-parameters/push))

## Aliases

* `&ruler`
* `&thirds`

## Options

Example: `&grid=./media/thirdshead.svg`

<table><thead><tr><th width="215">Value</th><th>Description</th></tr></thead><tbody><tr><td>(no value given)</td><td>adds a white rule-of-thirds grid overlay</td></tr><tr><td>(encoded URL)</td><td>adds an image as a overlay</td></tr></tbody></table>

## Details

Applies an rule-of-thirds grid overlay to the self-preview video window. This is useful for passively nudging guests to better center themselves while on camera.

{% hint style="warning" %}
As of [v19.0](https://docs.vdo.ninja/releases/v19), this only works for guests of a room or of a faux-room. It doesn't yet support basic push/view links, as those don't use the auto-mixer code, which is where this code is currently applied.
{% endhint %}

![default version of \&grid](https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2F9PxGutFybenitw3FiJje%2Fimage.png?alt=media\&token=a33a95b7-049c-41df-bbd6-1d0ca2677228)

### Changes in Version 22

Added the option to customize the `&grid` effect by passing an image link (can help center guests).

A transparent PNG or an SVG file are the recommended options.

It will stretch to cover the camera preview-area, so probably best to keep things 16:9 aspect if needed.

URL can be URL-encoded, for more complex URLs. Simple URLs might work without.

Technically this can be used as an overlay for other things, but it only works with the self-preview.

Example: [`https://vdo.ninja/?push&grid=./media/thirdshead.svg`](https://vdo.ninja/?push\&grid=./media/thirdshead.svg)

Leave the passed value empty if you wish to have the white basic rule-of-thirds show as default.

{% hint style="info" %}

* As of v22, it now works in non-room mode (basic push links):\
  <https://vdo.ninja/?push&grid>
* You can now also toggle it in the director's room to add it to the guest's link:\
  ![](https://2943598173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZHXv1G8N0MDxwotaT9%2Fuploads%2FaXHLjUkuR0K2No24Ekri%2Fimage.png?alt=media\&token=58a3084c-9295-4b57-b300-6e5b195a76ce)
  {% endhint %}

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