---
title: subtitle
framework: uikit
role: symbol
role_heading: Instance Property
path: uikit/uibutton/configuration-swift.struct/subtitle
---

# subtitle

The text the subtitle label of the button displays.

## Declaration

```swift
var subtitle: String? { get set }
```

## Discussion

Discussion This property matches the string value of the attributedSubtitle property. To change the button subtitle when the button state changes, use configurationUpdateHandler or updateConfiguration().

## See Also

### Configuring titles

- [title](uikit/uibutton/configuration-swift.struct/title.md)
- [attributedTitle](uikit/uibutton/configuration-swift.struct/attributedtitle.md)
- [attributedSubtitle](uikit/uibutton/configuration-swift.struct/attributedsubtitle.md)
- [titleTextAttributesTransformer](uikit/uibutton/configuration-swift.struct/titletextattributestransformer.md)
- [subtitleTextAttributesTransformer](uikit/uibutton/configuration-swift.struct/subtitletextattributestransformer.md)
- [UIConfigurationTextAttributesTransformer](uikit/uiconfigurationtextattributestransformer-swift.struct.md)
- [titlePadding](uikit/uibutton/configuration-swift.struct/titlepadding.md)
- [titleAlignment](uikit/uibutton/configuration-swift.struct/titlealignment-swift.property.md)
- [UIButton.Configuration.TitleAlignment](uikit/uibutton/configuration-swift.struct/titlealignment-swift.enum.md)
- [titleLineBreakMode](uikit/uibutton/configuration-swift.struct/titlelinebreakmode.md)
- [subtitleLineBreakMode](uikit/uibutton/configuration-swift.struct/subtitlelinebreakmode.md)