<!--
{
  "availability" : [
    "watchOS: 2.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "WatchKit",
  "identifier" : "/documentation/WatchKit/WKInterfaceActivityRing",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "WatchKit"
    ],
    "preciseIdentifier" : "c:objc(cs)WKInterfaceActivityRing"
  },
  "title" : "WKInterfaceActivityRing"
}
-->

# WKInterfaceActivityRing

A view that displays data from a HealthKit activity summary object.

```
class WKInterfaceActivityRing
```

## Overview

The [`WKInterfaceActivityRing`](/documentation/WatchKit/WKInterfaceActivityRing) view displays data from an <doc://com.apple.documentation/documentation/HealthKit/HKActivitySummary> object, using the Move, Exercise, and Stand activity rings (see [Figure 1](/documentation/watchkit/wkinterfaceactivityring#1965772)).

![](images/com.apple.watchkit/media-1965772@2x.png)

The activity ring view always appears as a black rectangle with red, green, and blue concentric rings. The rings are centered in the view, and sized to fit the available space (see [Figure 2](/documentation/watchkit/wkinterfaceactivityring#1965773)).

![](images/com.apple.watchkit/media-1965773@2x.png)

The rings have two different ways to display a lack of data. One indicates that the activity summary is missing, and the other indicates that the activity summary’s values are set to zero. If the ring has a `nil`-valued `activitySummary` property, the rings appear empty (see See [Figure 3](/documentation/watchkit/wkinterfaceactivityring#1965774)). Use this to indicate that there is no summary data available for the specified day (for example, dates in the future).

![](images/com.apple.watchkit/media-1965774@2x.png)

If the summary has zero-valued quantities set for its value properties,  the ring displays a dot at the top of the ring (see [Figure 4](/documentation/watchkit/wkinterfaceactivityring#1965776)). Use this to indicate that the user has not yet burned any active calories, exercised, or earned any stand hours for the specified day.

![](images/com.apple.watchkit/media-1965776@2x.png)

To display activity summary data from the HealthKit store, use an <doc://com.apple.documentation/documentation/HealthKit/HKActivitySummaryQuery> object. You can also instantiate and display your own <doc://com.apple.documentation/documentation/HealthKit/HKActivitySummary> objects, as needed.

To display data for a ring, the <doc://com.apple.documentation/documentation/HealthKit/HKActivitySummary> object must have a non-`nil` quantity for both the corresponding value property and goal property (see the following table).

|Ring    |Value property                                                                              |Goal property                                                                                   |
|--------|--------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
|Move    |<doc://com.apple.documentation/documentation/HealthKit/HKActivitySummary/activeEnergyBurned>|<doc://com.apple.documentation/documentation/HealthKit/HKActivitySummary/activeEnergyBurnedGoal>|
|Exercise|<doc://com.apple.documentation/documentation/HealthKit/HKActivitySummary/appleExerciseTime> |<doc://com.apple.documentation/documentation/HealthKit/HKActivitySummary/appleExerciseTimeGoal> |
|Stand   |<doc://com.apple.documentation/documentation/HealthKit/HKActivitySummary/appleStandHours>   |<doc://com.apple.documentation/documentation/HealthKit/HKActivitySummary/appleStandHoursGoal>   |

The activity ring view colors a percentage of each ring based on these properties, as shown here:

```objc
ring percent = value property quantity / goal property quantity
```

## Topics

### Setting the Activity Summary

[`setActivitySummary(_:animated:)`](/documentation/WatchKit/WKInterfaceActivityRing/setActivitySummary(_:animated:))

Sets the activity summary displayed by the activity ring view.

### Initializing for SwiftUI

[`init()`](/documentation/WatchKit/WKInterfaceActivityRing/init())

Creates an activity ring view for use in SwiftUI.



---

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)