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

# showsExpansionTextWhenTruncated

A Boolean value that determines whether the full text of the label displays when the pointer hovers over the truncated text.

```
var showsExpansionTextWhenTruncated: Bool { get set }
```

## Discussion

A label may truncate text too long to fit in its container based on the value of the label’s [`lineBreakMode`](/documentation/UIKit/UILabel/lineBreakMode) property. To provide the option in your app to show the full text when the pointer hovers over the truncated text, set [`showsExpansionTextWhenTruncated`](/documentation/UIKit/UILabel/showsExpansionTextWhenTruncated) to <doc://com.apple.documentation/documentation/Swift/true>. The default value is <doc://com.apple.documentation/documentation/Swift/false>.

![An illustration showing three views extending horizontally. Each view displays an icon on the left, followed by title and subtitle labels on the right side of the view. The title appears above the subtitle. A line with an arrow at the end extends from the first view to the second view, and from the second view to the third view. The first view shows an arrow pointer positioned outside of the view. The second view shows the pointer positioned over truncated text in the subtitle label. The third view shows the expanded text as the pointer continues to hover over the subtitle label.](images/com.apple.uikit/media-3875433@2x.png)

> Note:
> Text expansion is available in iPhone and iPad apps running on a Mac with Apple silicon and in Mac apps built with <doc://com.apple.uikit/documentation/UIKit/mac-catalyst>.

---

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)