---
title: alternateTitle
framework: appkit
role: symbol
role_heading: Instance Property
path: appkit/nsbutton/alternatetitle
---

# alternateTitle

The title that the button displays when the button is in an on state.

## Declaration

```swift
var alternateTitle: String { get set }
```

## Discussion

Discussion This property contains the string that appears on the button when the button is in an on state, or the empty string if the button doesn’t display an alternate title. By default, a button’s alternate title is Button.

## See Also

### Configuring buttons

- [setButtonType(_:)](appkit/nsbutton/setbuttontype(_:).md)
- [getPeriodicDelay(_:interval:)](appkit/nsbutton/getperiodicdelay(_:interval:).md)
- [setPeriodicDelay(_:interval:)](appkit/nsbutton/setperiodicdelay(_:interval:).md)
- [contentTintColor](appkit/nsbutton/contenttintcolor.md)
- [hasDestructiveAction](appkit/nsbutton/hasdestructiveaction.md)
- [attributedTitle](appkit/nsbutton/attributedtitle.md)
- [attributedAlternateTitle](appkit/nsbutton/attributedalternatetitle.md)
- [title](appkit/nsbutton/title.md)
- [symbolConfiguration](appkit/nsbutton/symbolconfiguration.md)
- [sound](appkit/nsbutton/sound.md)
- [isSpringLoaded](appkit/nsbutton/isspringloaded.md)
- [maxAcceleratorLevel](appkit/nsbutton/maxacceleratorlevel.md)
- [tintProminence](appkit/nsbutton/tintprominence.md)
- [NSTintProminence](appkit/nstintprominence.md)
- [borderShape](appkit/nsbutton/bordershape.md)