<!--
{
  "documentType" : "article",
  "framework" : "USD",
  "identifier" : "/documentation/USD/verticalalignment",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "verticalAlignment"
}
-->

# verticalAlignment

An option that controls the text’s vertical placement within its bounding rectangle.

## Discussion

The runtime handles each option of this property differently depending on whether the text displays with line breaks. For more information, see [wrapMode](/documentation/USD/wrapmode).

### Declaration

```other
token verticalAlignment = "center" (
    allowedTokens = ["top", "middle", "lowerMiddle", "baseline", "bottom"]
)
```

### Vertical Alignments for Single-Line Text

For a single line of text, the vertical alignment is relative to font features.

- `top`: Aligns the line of text vertically with the ascender.
- `middle`: Aligns the line of text vertically with the center of capital letters.
- `lowerMiddle`: Aligns the line of text vertically with the center of lowercase letters.
- `baseline`: Aligns the line of text vertically with the baseline.
- `bottom`: Aligns the line of text vertically with a descender.

### Vertical Alignments for Multiline Text

For multiline text, each line of text bases its vertical alignment on the text’s bounding box.

- `top`: Aligns each line of text vertically with the top.
- `middle, lowerMiddle`: Aligns each line of text in the center with equal space above and below the line of text.
- `baseline, bottom`: Aligns each line of text vertically with the bottom.

---

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)