---
title: "Word"
canonical_url: https://docs.zvid.io/docs/structure/properties/word/
source: docs/structure/properties/word.md
content_revision: 6338386a1dd87e4a
---

# Word

`Word` defines the timing for one word inside a subtitle caption.

Location: `payload.subtitle.captions[n].words[m]`. Both timestamps use
**absolute project seconds**, not seconds relative to the caption. Keep
`start < end`, words in chronological order, and each interval inside the
parent caption's interval. A caption beginning at 5 seconds has word times
such as 5.0–5.4, not 0.0–0.4.

```typescript
interface Word {
  start: number;
  end: number;
  text: string;
}
```

| Property | Required | Notes                       |
| -------- | -------- | --------------------------- |
| `start`  | Yes      | Word start time in seconds. |
| `end`    | Yes      | Word end time in seconds.   |
| `text`   | Yes      | Word text.                  |

Word timings drive the word-timed subtitle animations (`one-word`, `karaoke`,
`highlight`, `progressive`, `fill`, `pop`, `bounce`, `fade`, `typewriter`,
`slide`). Words are optional on a caption — when omitted, timings are
auto-distributed from the caption text.

## Used By

- [Caption](https://docs.zvid.io/docs/structure/properties/caption/)
- [Subtitle](https://docs.zvid.io/docs/structure/subtitle/)