---
title: currentTitle
framework: uikit
role: symbol
role_heading: Instance Property
path: uikit/uibutton/currenttitle
---

# currentTitle

The current title that is displayed on the button.

## Declaration

```swift
var currentTitle: String? { get }
```

## Discussion

Discussion The value for this property is set automatically whenever the button state changes. For states that do not have a custom title string associated with them, this method returns the title that is currently displayed, which is typically the one associated with the normal state. The value may be nil.

## See Also

### Related Documentation

- [titleLabel](uikit/uibutton/titlelabel.md)
- [setTitle(_:for:)](uikit/uibutton/settitle(_:for:).md)

### Getting the current state

- [buttonType](uikit/uibutton/buttontype-swift.property.md)
- [currentAttributedTitle](uikit/uibutton/currentattributedtitle.md)
- [currentTitleColor](uikit/uibutton/currenttitlecolor.md)
- [currentTitleShadowColor](uikit/uibutton/currenttitleshadowcolor.md)
- [currentImage](uikit/uibutton/currentimage.md)
- [currentBackgroundImage](uikit/uibutton/currentbackgroundimage.md)
- [currentPreferredSymbolConfiguration](uikit/uibutton/currentpreferredsymbolconfiguration.md)
- [imageView](uikit/uibutton/imageview.md)
- [subtitleLabel](uikit/uibutton/subtitlelabel.md)