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

# attributedAlternateTitle

The title displayed by the button when it’s in its alternate state, as an attributed string.

```
@NSCopying var attributedAlternateTitle: NSAttributedString { get set }
```

## Discussion

The value of this property is the attributed string that appears on the button when it’s in its alternate state, or the empty string if the button doesn’t display an alternate title. Note that some button types don’t display an alternate title. By default, a button’s alternate title is “Button.”

Graphics attributes that are set on the cell (such as `backgroundColor`, `alignment`, `font`, and so on) are overridden when corresponding properties are set for the attributed string.

## See Also

[`font`](/documentation/AppKit/NSCell/font)

The font that the cell uses to display text.

[`-  setAlternateMnemonicLocation:`](/documentation/AppKit/NSButtonCell/setAlternateMnemonicLocation:)

Sets the character in the alternate title that should be the “keyboard mnemonic.”

[`-  setAlternateTitleWithMnemonic:`](/documentation/AppKit/NSButtonCell/setAlternateTitleWithMnemonic:)

Sets the title the button displays when it’s in its alternate state to the given string with an embedded mnemonic.

[`-  alternateMnemonic`](/documentation/AppKit/NSButtonCell/alternateMnemonic)

Returns the character in the alternate title that’s marked as the “keyboard mnemonic.”

[`-  setButtonType:`](/documentation/AppKit/NSButtonCell/setButtonType(_:))

Sets how the button highlights while pressed and how it shows its state.


---

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)