<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIControl/toolTip",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)UIControl(py)toolTip"
  },
  "title" : "toolTip"
}
-->

# toolTip

The default text to display in the control’s tooltip.

```
var toolTip: String? { get set }
```

## Discussion

Set this property to the text that should appear in the tooltip. If you want your app to determine the tooltip text at a later time — for instance, to determine the text based on the current state of your app — set the [`delegate`](/documentation/UIKit/UIToolTipInteraction/delegate) property of [`toolTipInteraction`](/documentation/UIKit/UIControl/toolTipInteraction) after setting [`toolTip`](/documentation/UIKit/UIControl/toolTip) with the default text. For example, the following code listing sets the tooltip’s default text and delegate for a shopping cart button:

```swift
let button = UIButton(configuration: configuration, primaryAction: action)
button.toolTip = "Click to add the item to your cart. Your cart is empty."
button.toolTipInteraction?.delegate = self
```

If the delegate implements the method [`toolTipInteraction(_:configurationAt:)`](/documentation/UIKit/UIToolTipInteractionDelegate/toolTipInteraction(_:configurationAt:)), the tooltip ignores the default text set in the [`toolTip`](/documentation/UIKit/UIControl/toolTip) property. For more information, see [`toolTipInteraction`](/documentation/UIKit/UIControl/toolTipInteraction).

---

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)