# track.set_caption_style

> Merges a partial caption style into a track, or replaces it.

Source: https://alexgalhardo.github.io/vukem-video/pt-br/docs/reference/commands/track.set_caption_style/

Sets the caption style of a visual track. The style is stored exactly as given, including keys equal to the default. A null value removes a key when merging. In this build highlight accepts only "none".

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `replace` | `boolean` | no | Replace the whole style instead of merging. |
| `style` | `object` | yes | A partial CaptionStyle; null removes a key when merging. |
| `track_id` | `string` | yes |  |

## 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.set_caption_style",
  "args": {
    "style": {
      "position": "middle",
      "size": 72
    },
    "track_id": "trk_a1b2c3d4e5"
  }
}
```

## Errors

[`E_VALIDATION`](/docs/reference/error-codes#e_validation), [`E_NOT_FOUND`](/docs/reference/error-codes#e_not_found), [`E_TYPE_MISMATCH`](/docs/reference/error-codes#e_type_mismatch), [`E_FONT_UNKNOWN`](/docs/reference/error-codes#e_font_unknown)

## Scope and phase

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