<!--
{
  "documentType" : "article",
  "framework" : "ClockKit",
  "identifier" : "/documentation/ClockKit/adding-text-to-a-complication",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Adding text to a complication"
}
-->

# Adding text to a complication

Use text in SwiftUI complications.

## Discussion

When creating ClockKit templates with SwiftUI views, <doc://com.apple.documentation/documentation/SwiftUI/Text> views adapt their appearance based on the template’s complication family. The system automatically sets the font and size to match other templates in the same family.

### Match the Expected Font Size

Use the default font size as a guide for the type of information your complication displays. For example, the [`CLKComplicationTemplateGraphicExtraLargeCircularView`](/documentation/ClockKit/CLKComplicationTemplateGraphicExtraLargeCircularView) template provides a large canvas for drawing, but it’s intended to present large, easy-to-read content instead of a lot of small, detailed data.

### Use Text Formatters

When displaying dates and times, use <doc://com.apple.documentation/documentation/SwiftUI/Text/DateStyle> to create localized strings. <doc://com.apple.documentation/documentation/SwiftUI/Text/DateStyle> also defines formatters such as <doc://com.apple.documentation/documentation/SwiftUI/Text/DateStyle/relative>, <doc://com.apple.documentation/documentation/SwiftUI/Text/DateStyle/offset>, and <doc://com.apple.documentation/documentation/SwiftUI/Text/DateStyle/timer>. ClockKit automatically updates information in these formatters, and you can use these formatters when instantiating a <doc://com.apple.documentation/documentation/SwiftUI/Text> view.

```swift
Text(myEvent.startDate, style: .timer)
```

Or use them inline in an interpolated string.

```swift
Text("\(myEvent.name) starts in \(myEvent.startDate, style: .timer)")
```

![A preview of a large rectangular complication with a text view that displays a timer that automatically counts down to the next event.](images/com.apple.clockkit/media-3666648@2x.png)

---

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)