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

# attributedTitle

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

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

## Discussion

The value of this property is the attributes string that appears on the button when it’s in its normal state, or an empty attributed string if the button doesn’t display a title. A button’s title is always displayed if the button doesn’t use its alternate contents for highlighting or displaying the alternate state. By default, a button’s title is “Button.” Setting this property redraws the button if necessary.

Graphics attributes configured for 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.

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

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

[`-  mnemonic`](/documentation/AppKit/NSCell/mnemonic)

Returns the character in the receiver’s title that appears underlined for use as a mnemonic.


---

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)