<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: -",
    "macOS: 27.0.0 -",
    "visionOS: 27.0.0 -",
    "watchOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "HealthKit",
  "identifier" : "/documentation/HealthKit/HKHealthStore/preferredWorkoutZoneConfiguration(for:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "HealthKit"
    ],
    "preciseIdentifier" : "s:So13HKHealthStoreC9HealthKitE33preferredWorkoutZoneConfiguration3forAC09HKWorkoutgH0VSgSo14HKQuantityTypeC_tYaKF"
  },
  "title" : "preferredWorkoutZoneConfiguration(for:)"
}
-->

# preferredWorkoutZoneConfiguration(for:)

Returns a person’s preferred zone configuration for a quantity type.

```
func preferredWorkoutZoneConfiguration(for quantityType: HKQuantityType) async throws -> HKWorkoutZoneConfiguration?
```

## Parameters

`quantityType`

The quantity type for which to retrieve the preferred zone configuration.

## Return Value

The preferred zone configuration, or `nil` if the person hasn’t configured zones for the quantity type.

## Discussion

The system returns the person’s manually configured zones from Health Settings, or the system-generated zones if the person hasn’t set custom values. System-generated zones update periodically as the person’s health metrics change, however, the system preserves zones that the person configures. Use this method to display zone information that aligns with the person’s preferences across their workouts.

This method throws an error if the framework can’t retrieve the requested zone configuration.

---

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)