<!--
{
  "availability" : [
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSButton/alternateTitle",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(cs)NSButton(py)alternateTitle"
  },
  "title" : "alternateTitle"
}
-->

# alternateTitle

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

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

## 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.

---

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)