View as markdown

Avatar dock

Each slide can place the agent's avatar in one of three positions, with optional per-slide overrides for shape and visibility.

Three modes

Deck-wide vs per-slide

You can set a deck-wide default in the deck settings, then override on individual slides:

  1. Set deck default

    In the deck settings, choose agentPosition = left / right / pip. This applies to every slide unless overridden.

  2. Override per slide

    On any slide's avatar settings panel, pick a different dock. The per-slide setting wins.

Mobile behavior

On viewports under ~768px, the avatar always renders as PIP regardless of the configured dock — there's not enough room for a side dock to read well. Your dock choice still applies on desktop.

The 5-slide live-layer tour at /a/live-layer-tour demonstrates each mode. Slide 2 uses side-right, slide 3 uses inside (PIP top-right circle), slides 1/4/5 use side-left.

Schema reference

NameTypeDescription
dock"side-left" | "side-right" | "inside"Where the avatar sits on this slide
pipShape"circle" | "rounded" | "rectangle"Shape when dock = inside (default circle)
pipCorner"top-left" | "top-right" | "bottom-left" | "bottom-right"Corner when dock = inside (default top-right)
visiblebooleanHide the avatar wrapper but keep the audio session live