<!--
{
  "documentType" : "article",
  "framework" : "professional_video_applications",
  "identifier" : "/documentation/Professional-Video-Applications/text",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "text"
}
-->

# text

Describes a block of text that appears in a title or caption on a timeline.

## Discussion

You can have one or more text blocks in a title or caption.

A text block can have different text styles. Use the `text-style` and `text-style-def` elements to describe the text style for each portion. Use the [Text Element Caption Attributes](/documentation/Professional-Video-Applications/text#Text-Element-Caption-Attributes) when describing a caption text block.

> Note:
> FCPXML 1.8 and later includes support to describie caption and subtitles.

### Text Element Caption Attributes

|Element         |Description                                                                                                                                                                                                                                                                                                                                           |
|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|`display-style` |Specifies how a text block in a CEA-608 caption appears during playback. Valid values are: ![](spacer) `pop-on` — Displays all text at once. ![](spacer) `paint-on` — Displays text one character at a time as if it’s being written in real-time. ![](spacer) `roll-up` — Displays one line of text at a time, and new lines roll up from the bottom.|
|`roll-up-height`|Specifies the number of lines to use for the roll-up animation.                                                                                                                                                                                                                                                                                       |
|`position`      |Specifies the relative position of a text block in a CEA-608 caption in the video frame, for example “`4 1`”.                                                                                                                                                                                                                                         |
|`placement`     |Specifies the relative position of an ITT (iTunes Timed Text) subtitle text block in the video frame. Valid values are: `top`, `bottom`, `left`, and `right`. ![](spacer) **Note**: This attribute is ignored for a SRT (SubRip Text) caption text block.                                                                                             |
|`alignment`     |Specifies the relative position of a text block in a CEA-608 caption in the video frame. Valid values are: `left`, `center`, and `right`.                                                                                                                                                                                                             |

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)