# Timeline

The Timeline is the primary composition tool. It arranges clips in time across multiple tracks and displays the playhead position.

![Timeline overview](/files/F2YcCnQwubzvrOzRR9Xt)

## Anatomy of the Timeline

```
  ┌──────┬───────────────────────────────────────────────────────────┐
  │Track │  0s          5s          10s         15s         20s      │
  ├──────┼───────────────────────────────────────────────────────────┤
  │  1   │  [══ Background Loop ═════════════════════════════════]   │
  ├──────┼───────────────────────────────────────────────────────────┤
  │  2   │              [══ Title Graphic ══]                        │
  ├──────┼───────────────────────────────────────────────────────────┤
  │  3   │                                    [══ Outro ══]          │
  └──────┴───────────────────────────────────────────────────────────┘
                    ▲
               Playhead
```

## Tracks

* Each screen can have an **unlimited number of tracks**.
* Tracks are stacked with Track 1 at the bottom (rendered first, lowest layer).
* Click **+ Track** to add a new track above the current stack.
* Drag the track header to reorder.

## Clips

| Action           | How                             |
| ---------------- | ------------------------------- |
| **Add**          | Drag from File Browser          |
| **Move**         | Drag the clip body              |
| **Trim start**   | Drag the left edge              |
| **Trim end**     | Drag the right edge             |
| **Delete**       | Select + `Delete` key           |
| **Duplicate**    | `Ctrl+D`                        |
| **Split**        | Position playhead and press `S` |
| **Snap to grid** | Hold `Ctrl` while dragging      |

## Playhead

* **Click** anywhere on the ruler to jump to that time.
* **Drag** the playhead handle to scrub.
* The timecode display in the Transport bar always reflects the playhead position.

## Zoom and Scroll

| Action              | How                                          |
| ------------------- | -------------------------------------------- |
| Zoom in / out       | `Ctrl + scroll wheel`                        |
| Scroll horizontally | `Shift + scroll wheel` or drag the scrollbar |
| Fit all clips       | Press `F` (fit to view)                      |
| Go to start         | `Home` key                                   |
| Go to end           | `End` key                                    |

## Loop Region

Set a loop region by right-clicking on the ruler and choosing **Set Loop Start / End**. Press `L` to toggle looping of the region during playback.

## Transitions

Overlapping clips on the same track creates an automatic crossfade. The overlap duration determines the crossfade length. Adjust the transition type in the [Inspector](/v3/user-interface/inspector.md).


---

# 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.exaplay.one/v3/user-interface/timeline.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.