Quality Measure Implementation Guide
2.0.0-ballot - STU 2 Ballot

Quality Measure Implementation Guide - Downloaded Version null See the Directory of published versions

## Extension: CQM Supplemental Data Guidance

Official URL: http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-supplementalDataGuidance | Version: 2.0.0 | Highlight text changes?
Standards status: Trial-use Active as of 2026-04-07 | Maturity Level: 4 | Computable Name: CQMSupplementalDataGuidance
Other Identifiers: OID:2.16.840.1.113883.4.642.40.61.42.30

Provides additional guidance on the meaning and reporting of supplemental data elements included in the measure overall.

Context of Use

This extension may be used on the following element(s)

- Element ID: `Measure`

Usage info

Usages:

- Use this Extension: CQM Publishable Measure
- Examples for this Extension: HBPComponent

You can also check for usages in the FHIR IG Statistics

### Formal Views of Extension Content

Description Differentials, Snapshots, and other representations.

- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Supplemental data guidance
Slices for extension |  |  |  | Content/Rules for all slices
extension:usage |  | 1..1 | Extension | Kind of supplemental data
url |  | 1..1 | uri | "usage"
value[x] |  | 0..1 | CodeableConcept | Value of extension Binding: MeasureDataUsage (extensible)
extension:guidance |  | 1..1 | Extension | Additional guidance
url |  | 1..1 | uri | "guidance"
value[x] |  | 0..1 | markdown | Value of extension
url |  | 1..1 | uri | "http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-supplementalDataGuidance"
value[x] |  | 0..0 |  | Value of extension
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Extension.extension:usage.​value[x] | Base | extensible | MeasureDataUsage | 📦1.0.1 | THO v7.1

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Supplemental data guidance
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 2..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
extension:usage |  | 1..1 | Extension | Kind of supplemental data
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "usage"
value[x] |  | 0..1 | CodeableConcept | Value of extension Binding: MeasureDataUsage (extensible)
extension:guidance |  | 1..1 | Extension | Additional guidance
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "guidance"
value[x] |  | 0..1 | markdown | Value of extension
url |  | 1..1 | uri | "http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-supplementalDataGuidance"
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.extension:usage.​value[x] | Base | extensible | MeasureDataUsage | 📦1.0.1 | THO v7.1

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

Summary

Complex Extension: Provides additional guidance on the meaning and reporting of supplemental data elements included in the measure overall.

- usage: CodeableConcept: Specifies what kind of supplemental data elements this additional guidance is for (e.g. Supplemental Data Elements, Risk Adjustment Factors, etc.).
- guidance: markdown: Additional guidance related to the collection and reporting of this type of supplemental data defined on the measure.

Maturity: 4

Differential ViewDifferential View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Supplemental data guidance
Slices for extension |  |  |  | Content/Rules for all slices
extension:usage |  | 1..1 | Extension | Kind of supplemental data
url |  | 1..1 | uri | "usage"
value[x] |  | 0..1 | CodeableConcept | Value of extension Binding: MeasureDataUsage (extensible)
extension:guidance |  | 1..1 | Extension | Additional guidance
url |  | 1..1 | uri | "guidance"
value[x] |  | 0..1 | markdown | Value of extension
url |  | 1..1 | uri | "http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-supplementalDataGuidance"
value[x] |  | 0..0 |  | Value of extension
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Extension.extension:usage.​value[x] | Base | extensible | MeasureDataUsage | 📦1.0.1 | THO v7.1

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Supplemental data guidance
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 2..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
extension:usage |  | 1..1 | Extension | Kind of supplemental data
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "usage"
value[x] |  | 0..1 | CodeableConcept | Value of extension Binding: MeasureDataUsage (extensible)
extension:guidance |  | 1..1 | Extension | Additional guidance
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "guidance"
value[x] |  | 0..1 | markdown | Value of extension
url |  | 1..1 | uri | "http://hl7.org/fhir/uv/cqm/StructureDefinition/cqm-supplementalDataGuidance"
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.extension:usage.​value[x] | Base | extensible | MeasureDataUsage | 📦1.0.1 | THO v7.1

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

Summary

Complex Extension: Provides additional guidance on the meaning and reporting of supplemental data elements included in the measure overall.

- usage: CodeableConcept: Specifies what kind of supplemental data elements this additional guidance is for (e.g. Supplemental Data Elements, Risk Adjustment Factors, etc.).
- guidance: markdown: Additional guidance related to the collection and reporting of this type of supplemental data defined on the measure.

Maturity: 4

Other representations of profile: CSV, Excel, Schematron