vo2Max: HealthKit quantity type
HKQuantityTypeIdentifierVO2Max · read from Apple’s documentation on 2026-10-02
HKQuantityTypeIdentifier.vo2Max (Objective-C HKQuantityTypeIdentifierVO2Max) is a HealthKit quantity type in Apple's "Activity" group. Apple's abstract: “A quantity sample that measures the maximal oxygen consumption during exercise.” Apple's discussion says its samples use volume/mass/time units and measure discrete values, so in HKStatisticsQuery it takes .discreteAverage, .discreteMin or .discreteMax. It is available from iOS 11.0 and watchOS 4.0. This site's verified cross-platform matrix pairs it with Vo2MaxRecord on Android Health Connect in its VO2 max row, with the caveat “An estimate on both platforms, not a lab measurement.”
What Apple says vo2Max is
A quantity sample that measures the maximal oxygen consumption during exercise.
Apple’s abstract, quoted from its vo2Max reference page, read 2026-10-02. Apple’s discussion of the type runs 323 words.
- Swift
HKQuantityTypeIdentifier.vo2Max- Objective-C
HKQuantityTypeIdentifierVO2Max- Family
HKQuantityTypeIdentifier- Apple's topic group
- Activity
- Group page
- Activity
- Apple's reference
- vo2Max on developer.apple.com
Availability
The versions Apple’s documentation data gives for vo2Max, platform by platform, as read on 2026-10-02.
| Platform | Introduced | Deprecated |
|---|---|---|
| iOS | 11.0 | — |
| iPadOS | 11.0 | — |
| Mac Catalyst | 13.0 | — |
| macOS | 13.0 | — |
| visionOS | 1.0 | — |
| watchOS | 4.0 | — |
The rest of that release: HealthKit Types Introduced in iOS 11.
Sum or average, and in which units
Apple states both of these in the prose of the type’s discussion, not as properties, so they are derived from Apple’s sentence and the sentence is shown with each.
Aggregation style
discrete — in an HKStatisticsQuery, use .discreteAverage, .discreteMin or .discreteMax. Apple’s sentence:
They measure discrete values (described in ).
Unit family
volume/mass/time — every type in this family is on the HKUnit reference.
The generator read this unit family from a sentence of Apple’s discussion that the dataset does not store — it keeps one sentence per type, and for vo2Max that sentence states the aggregation, not the unit — so it cannot be quoted here. Apple’s page has it.
Empty parentheses and a dangling “described in” mark links in Apple’s sentence to other documentation pages: the generator keeps the sentence’s text, not its links, and the quote is left as stored rather than repaired.
Can apps write vo2Max?
Apple’s documentation for vo2Max does not state that its samples are read-only. Apple states read-only status only in prose, and its silence is not a statement either way, so this page makes no claim that apps can save it.
On Android Health Connect
The verified cross-platform matrix pairs vo2Max with Vo2MaxRecord in its VO2 max row.
An estimate on both platforms, not a lab measurement. Health Connect tags a measurement method.
The metric guide for this row: VO2 max on every platform.
Questions
- Should I sum or average vo2Max in HealthKit?
- Average it, or take its minimum or maximum — do not sum it. Apple's documentation for vo2Max describes it as measuring discrete values, so an HKStatisticsQuery over it takes .discreteAverage, .discreteMin or .discreteMax. Apple's sentence, as read on 2026-10-02: "They measure discrete values (described in )."
- Which unit family does Apple give vo2Max?
- Volume/mass/time. The dataset this site generates from Apple's documentation derived that from a sentence of Apple's discussion it does not store, so the sentence is not quoted here; Apple's page for vo2Max carries it.
- Does vo2Max have a Health Connect equivalent?
- This site's verified cross-platform matrix pairs HealthKit's vo2Max with Vo2MaxRecord in its VO2 max row. The caveat recorded with that row: An estimate on both platforms, not a lab measurement. Health Connect tags a measurement method.
- Which iOS version added vo2Max?
- iOS 11.0. Apple's availability data for vo2Max lists iOS 11.0, iPadOS 11.0, Mac Catalyst 13.0, macOS 13.0, visionOS 1.0 and watchOS 4.0.
Sources checked
- Apple — HKQuantityTypeIdentifier.vo2Max · read 2026-10-02
- Apple — HKQuantityTypeIdentifier · read 2026-10-02
Apple’s abstract and sentences are quoted for identification; the page layout, the capsule and the cross-platform pairing are AIFitnessAPI’s. Generated from Apple’s documentation by scripts/fetch-healthkit-identifiers.mjs, not typed by hand — the same data as the full identifier table.