<!--
{
  "availability" : [
    "iOS: 16.0.0 -",
    "iPadOS: 16.0.0 -",
    "macCatalyst: 16.0.0 -",
    "visionOS: 26.0.0 -",
    "watchOS: 9.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/View/widgetLabel(_:)-7wguh",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI4ViewP9WidgetKitE11widgetLabelyQrqd__SyRd__lF"
  },
  "title" : "widgetLabel(_:)"
}
-->

# widgetLabel(_:)

Returns a text label that displays additional content outside the
accessory family widget’s main SwiftUI view.

```
@MainActor @preconcurrency func widgetLabel<S>(_ label: S) -> some View where S : StringProtocol
```

## Parameters

`label`

A string that contains the text which WidgetKit
displays alongside the complication.

## Discussion

To add a text label to an accessory family widget, call this method on
the widget’s main SwiftUI view, and pass in a supported
<doc://com.apple.documentation/documentation/swiftui/LocalizedStringKey>.
The system determines whether it can use the text label. If it can’t, it
ignores the label. The system also sets the label’s size, placement, and
style. For example, setting the font and rendering the text along
a curve.

The following widget families support text accessory labels:

- The <doc://com.apple.documentation/documentation/WidgetKit/WidgetFamily/accessoryCorner> widget-based
  complication can display a curved text label on the inside edge of the
  corner. Adding a label to an accessory corner complication causes the
  main SwiftUI view to shrink to make space for the label.
- The <doc://com.apple.documentation/documentation/WidgetKit/WidgetFamily/accessoryCircular> widget can display
  a text label in watchOS; however, WidgetKit only renders the label along
  the bezel on the Infograph watch face (the top circular complication).

---

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)