# track.add

> Adds an empty track at a place in the track order.

Source: https://alexgalhardo.github.io/vukem-video/docs/reference/commands/track.add

Adds a visual or audio track. It goes on top by default; position bottom, above or below another track places it elsewhere. The first track in the order is the top layer.

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `above` | `string` | no | Place the track directly over this track. |
| `below` | `string` | no | Place the track directly under this track. |
| `id` | `string` | no |  |
| `kind` | `visual`, `audio` | yes |  |
| `name` | `string` | no |  |
| `position` | `top`, `bottom` | no | top (default) or bottom. |

## Example

As one operation of an `edit` batch (the `edit` tool of MCP, `vukem-video edit --ops`, or `POST /api/v1/projects/{id}/edit`):

```json
{
  "op": "track.add",
  "args": {
    "id": "trk_a1b2c3d4e5",
    "kind": "visual",
    "name": "Captions"
  }
}
```

## Errors

[`E_VALIDATION`](/docs/reference/error-codes#e_validation), [`E_NOT_FOUND`](/docs/reference/error-codes#e_not_found), [`E_ID_EXISTS`](/docs/reference/error-codes#e_id_exists), [`E_LIMIT`](/docs/reference/error-codes#e_limit)

## Scope and phase

Scope `edit`, phase `prototype`. Run `vukem-video command:help track.add` for the same description from the binary.
