<!--
{
  "availability" : [
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "WatchKit",
  "identifier" : "/documentation/WatchKit/WKInterfaceButton/setTitle(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "WatchKit"
    ],
    "preciseIdentifier" : "c:objc(cs)WKInterfaceButton(im)setTitle:"
  },
  "title" : "setTitle(_:)"
}
-->

# setTitle(_:)

Sets the button title to the specified string.

```
func setTitle(_ title: String?)
```

## Parameters

`title`

The text to display in the button. Specifying `nil` clears the current text from the button.

## Discussion

This method looks for a localized version of `title` in your WatchKit extension’s `Localizable.strings` file. If it finds one, it uses the localized string for the button title. If it does not find a localized version of the string, it uses the value in the `title` parameter directly. The text replaces the previous text set for the button.

The button text is drawn using the font and styling information from your storyboard. The text is drawn on top of the button’s background image or color.

## See Also

  [App Programming Guide for watchOS](https://developer.apple.com/library/archive/documentation/General/Conceptual/WatchKitProgrammingGuide/index.html#//apple_ref/doc/uid/TP40014969)


---

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)