> ## Documentation Index
> Fetch the complete documentation index at: https://docs.framelane.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Transition Examples

> Request bodies for transitions between elements.

Transitions go in the top-level `transitions` array. Each transition references two element `id` values via `from_id` (outgoing) and `to_id` (incoming).

<Warning>
  Elements used in transitions must have an `id` set. For **text** and **image** elements, `duration` is also required.
</Warning>

## Cross dissolve

Fade between two video clips. The `time` values create a sequential timeline; the transition overlaps the cut.

```json theme={null}
{
  "width": 1920,
  "height": 1080,
  "duration": 12,
  "elements": [
    {
      "type": "video",
      "id": "clip_a",
      "source_url": "https://cdn.example.com/clip-a.mp4",
      "time": 0
    },
    {
      "type": "video",
      "id": "clip_b",
      "source_url": "https://cdn.example.com/clip-b.mp4",
      "time": 6
    }
  ],
  "transitions": [
    { "type": "cross_dissolve", "duration": 1.0, "from_id": "clip_a", "to_id": "clip_b" }
  ]
}
```

## Wipe left

```json theme={null}
{
  "width": 1920,
  "height": 1080,
  "duration": 12,
  "elements": [
    {
      "type": "video",
      "id": "clip_a",
      "source_url": "https://cdn.example.com/clip-a.mp4",
      "time": 0
    },
    {
      "type": "video",
      "id": "clip_b",
      "source_url": "https://cdn.example.com/clip-b.mp4",
      "time": 6
    }
  ],
  "transitions": [
    {
      "type": "wipe_left",
      "duration": 0.8,
      "from_id": "clip_a",
      "to_id": "clip_b"
    }
  ]
}
```

## All transition types

| `type`                  | Description                                        |
| ----------------------- | -------------------------------------------------- |
| `cross_dissolve`        | Standard crossfade (Premiere: Cross Dissolve)      |
| `dip_to_black`          | Fade through black (Premiere: Dip to Black)        |
| `dip_to_white`          | Fade through white (Premiere: Dip to White)        |
| `wipe_left`             | Wipe to the left                                   |
| `wipe_right`            | Wipe to the right                                  |
| `wipe_up`               | Wipe upward                                        |
| `wipe_down`             | Wipe downward                                      |
| `diagonal_wipe`         | Diagonal wipe                                      |
| `barn_doors_horizontal` | Horizontal barn doors open/close                   |
| `barn_doors_vertical`   | Vertical barn doors open/close                     |
| `iris`                  | Iris / concentric circle wipe                      |
| `page_turn`             | Page turn / peel                                   |
| `cross_zoom`            | Zoom dissolve between clips (Premiere: Cross Zoom) |
| `gradient_wipe`         | Gradient-based wipe (Premiere: Gradient Wipe)      |
| `band_wipe`             | Band wipe (Premiere: Band Wipe)                    |
| `box_wipe`              | Box shrink / grow wipe (Premiere: Box Wipe)        |