Clinical Practice Guidelines
3.0.0-ballot - STU 3 Ballot International flag

Clinical Practice Guidelines, published by HL7 International / Clinical Decision Support. This guide is not an authorized publication; it is the continuous build for version 3.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/cqf-recommendations/ and changes regularly. See the Directory of published versions

Resource Profile: CPG Group

Official URL: http://hl7.org/fhir/uv/cpg/StructureDefinition/cpg-group Version: 3.0.0-ballot
Active as of 2026-11-10 Computable Name: CPGGroup
Other Identifiers: OID:2.16.840.1.113883.4.642.40.48.42.67

Defines an actual group of subjects, suitable for use in various contexts, such as a enrollment in a pathway or participant in a study

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description Differentials, Snapshots, and other representations.

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Group C 0..* Group Group of multiple entities
Constraints: grp-1
Group.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Group.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Group.identifier This element must be supported. This element is included in summaries. 0..* Identifier Unique id
Group.active This element must be supported. This element is included in summaries. 0..1 boolean Whether this group's record is in active use
Group.type This element must be supported. This element is included in summaries. 1..1 code person | animal | practitioner | device | medication | substance
Binding: GroupType (required): Types of resources that are part of group.
Fixed Value: person (no extensions allowed)
Group.actual This element must be supported. This element is included in summaries. C 1..1 boolean Descriptive or actual
Fixed Value: true (no extensions allowed)
Group.code This element must be supported. This element is included in summaries. 0..1 CodeableConcept Kind of Group members
Binding Description: (example): Kind of particular resource; e.g. cow, syringe, lake, etc.
Group.name This element must be supported. This element is included in summaries. 0..1 string Label for Group
Group.member This element must be supported. C 0..* BackboneElement Who or what is in group
Group.member.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Group.member.entity This element must be supported. 1..1 Reference(CPG Patient) Reference to the group member
Group.member.period This element must be supported. 0..1 Period Period member belonged to the group
Group.member.inactive This element must be supported. 0..1 boolean If member is no longer in group

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Group.type Base required GroupType 📍4.0.1 FHIR Std.
Group.code Base example Not State Unknown
Group.characteristic.​code Base example Not State Unknown
Group.characteristic.​value[x] Base example Not State Unknown

Constraints

Id Grade Path(s) Description Expression
dom-2 error Group If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Group If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Group If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Group If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Group A resource should have narrative for robust management text.`div`.exists()
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()
grp-1 error Group Can only have members if group is "actual" member.empty() or (actual = true)

This structure is derived from Group

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Group 0..* Group Group of multiple entities
Group.identifier This element must be supported. 0..* Identifier Unique id
Group.active This element must be supported. 0..1 boolean Whether this group's record is in active use
Group.type This element must be supported. 1..1 code person | animal | practitioner | device | medication | substance
Fixed Value: person (no extensions allowed)
Group.code This element must be supported. 0..1 CodeableConcept Kind of Group members
Group.name This element must be supported. 0..1 string Label for Group
Group.characteristic 0..0 Include / Exclude group members by Trait
Group.member This element must be supported. 0..* BackboneElement Who or what is in group
Group.member.entity This element must be supported. 1..1 Reference(CPG Patient) Reference to the group member
Group.member.period This element must be supported. 0..1 Period Period member belonged to the group
Group.member.inactive This element must be supported. 0..1 boolean If member is no longer in group

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: doco
Group C 0..* Group Group of multiple entities
Constraints: grp-1
Group.id This element is included in summaries. 0..1 id Logical id of this artifact
Group.meta This element is included in summaries. 0..1 Meta Metadata about the resource
Group.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Group.language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
Group.text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Group.contained 0..* Resource Contained, inline Resources
Group.extension 0..* Extension Additional content defined by implementations
Group.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Group.identifier This element must be supported. This element is included in summaries. 0..* Identifier Unique id
Group.active This element must be supported. This element is included in summaries. 0..1 boolean Whether this group's record is in active use
Group.type This element must be supported. This element is included in summaries. 1..1 code person | animal | practitioner | device | medication | substance
Binding: GroupType (required): Types of resources that are part of group.
Fixed Value: person (no extensions allowed)
Group.actual This element must be supported. This element is included in summaries. C 1..1 boolean Descriptive or actual
Fixed Value: true (no extensions allowed)
Group.code This element must be supported. This element is included in summaries. 0..1 CodeableConcept Kind of Group members
Binding Description: (example): Kind of particular resource; e.g. cow, syringe, lake, etc.
Group.name This element must be supported. This element is included in summaries. 0..1 string Label for Group
Group.quantity This element is included in summaries. 0..1 unsignedInt Number of members
Group.managingEntity This element is included in summaries. 0..1 Reference(Organization | RelatedPerson | Practitioner | PractitionerRole) Entity that is the custodian of the Group's definition
Group.member This element must be supported. C 0..* BackboneElement Who or what is in group
Group.member.id 0..1 string Unique id for inter-element referencing
Group.member.extension 0..* Extension Additional content defined by implementations
Group.member.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Group.member.entity This element must be supported. 1..1 Reference(CPG Patient) Reference to the group member
Group.member.period This element must be supported. 0..1 Period Period member belonged to the group
Group.member.inactive This element must be supported. 0..1 boolean If member is no longer in group

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Group.language Base preferred Common Languages 📍4.0.1 FHIR Std.
Group.type Base required GroupType 📍4.0.1 FHIR Std.
Group.code Base example Not State Unknown
Group.characteristic.​code Base example Not State Unknown
Group.characteristic.​value[x] Base example Not State Unknown

Constraints

Id Grade Path(s) Description Expression
dom-2 error Group If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Group If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Group If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Group If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Group A resource should have narrative for robust management text.`div`.exists()
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()
grp-1 error Group Can only have members if group is "actual" member.empty() or (actual = true)

This structure is derived from Group

Summary

Must-Support: 10 elements
Fixed: 2 elements
Prohibited: 1 element

Structures

This structure refers to these other structures:

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Group C 0..* Group Group of multiple entities
Constraints: grp-1
Group.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Group.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Group.identifier This element must be supported. This element is included in summaries. 0..* Identifier Unique id
Group.active This element must be supported. This element is included in summaries. 0..1 boolean Whether this group's record is in active use
Group.type This element must be supported. This element is included in summaries. 1..1 code person | animal | practitioner | device | medication | substance
Binding: GroupType (required): Types of resources that are part of group.
Fixed Value: person (no extensions allowed)
Group.actual This element must be supported. This element is included in summaries. C 1..1 boolean Descriptive or actual
Fixed Value: true (no extensions allowed)
Group.code This element must be supported. This element is included in summaries. 0..1 CodeableConcept Kind of Group members
Binding Description: (example): Kind of particular resource; e.g. cow, syringe, lake, etc.
Group.name This element must be supported. This element is included in summaries. 0..1 string Label for Group
Group.member This element must be supported. C 0..* BackboneElement Who or what is in group
Group.member.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Group.member.entity This element must be supported. 1..1 Reference(CPG Patient) Reference to the group member
Group.member.period This element must be supported. 0..1 Period Period member belonged to the group
Group.member.inactive This element must be supported. 0..1 boolean If member is no longer in group

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Group.type Base required GroupType 📍4.0.1 FHIR Std.
Group.code Base example Not State Unknown
Group.characteristic.​code Base example Not State Unknown
Group.characteristic.​value[x] Base example Not State Unknown

Constraints

Id Grade Path(s) Description Expression
dom-2 error Group If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Group If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Group If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Group If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Group A resource should have narrative for robust management text.`div`.exists()
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()
grp-1 error Group Can only have members if group is "actual" member.empty() or (actual = true)

Differential View

This structure is derived from Group

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Group 0..* Group Group of multiple entities
Group.identifier This element must be supported. 0..* Identifier Unique id
Group.active This element must be supported. 0..1 boolean Whether this group's record is in active use
Group.type This element must be supported. 1..1 code person | animal | practitioner | device | medication | substance
Fixed Value: person (no extensions allowed)
Group.actual This element must be supported. 1..1 boolean Descriptive or actual
Fixed Value: true (no extensions allowed)
Group.code This element must be supported. 0..1 CodeableConcept Kind of Group members
Group.name This element must be supported. 0..1 string Label for Group
Group.characteristic 0..0 Include / Exclude group members by Trait
Group.member This element must be supported. 0..* BackboneElement Who or what is in group
Group.member.entity This element must be supported. 1..1 Reference(CPG Patient) Reference to the group member
Group.member.period This element must be supported. 0..1 Period Period member belonged to the group
Group.member.inactive This element must be supported. 0..1 boolean If member is no longer in group

doco Documentation for this format

Snapshot ViewView

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Group C 0..* Group Group of multiple entities
Constraints: grp-1
Group.id This element is included in summaries. 0..1 id Logical id of this artifact
Group.meta This element is included in summaries. 0..1 Meta Metadata about the resource
Group.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
Group.language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
Group.text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Group.contained 0..* Resource Contained, inline Resources
Group.extension 0..* Extension Additional content defined by implementations
Group.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Group.identifier This element must be supported. This element is included in summaries. 0..* Identifier Unique id
Group.active This element must be supported. This element is included in summaries. 0..1 boolean Whether this group's record is in active use
Group.type This element must be supported. This element is included in summaries. 1..1 code person | animal | practitioner | device | medication | substance
Binding: GroupType (required): Types of resources that are part of group.
Fixed Value: person (no extensions allowed)
Group.actual This element must be supported. This element is included in summaries. C 1..1 boolean Descriptive or actual
Fixed Value: true (no extensions allowed)
Group.code This element must be supported. This element is included in summaries. 0..1 CodeableConcept Kind of Group members
Binding Description: (example): Kind of particular resource; e.g. cow, syringe, lake, etc.
Group.name This element must be supported. This element is included in summaries. 0..1 string Label for Group
Group.quantity This element is included in summaries. 0..1 unsignedInt Number of members
Group.managingEntity This element is included in summaries. 0..1 Reference(Organization | RelatedPerson | Practitioner | PractitionerRole) Entity that is the custodian of the Group's definition
Group.member This element must be supported. C 0..* BackboneElement Who or what is in group
Group.member.id 0..1 string Unique id for inter-element referencing
Group.member.extension 0..* Extension Additional content defined by implementations
Group.member.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized
Group.member.entity This element must be supported. 1..1 Reference(CPG Patient) Reference to the group member
Group.member.period This element must be supported. 0..1 Period Period member belonged to the group
Group.member.inactive This element must be supported. 0..1 boolean If member is no longer in group

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Group.language Base preferred Common Languages 📍4.0.1 FHIR Std.
Group.type Base required GroupType 📍4.0.1 FHIR Std.
Group.code Base example Not State Unknown
Group.characteristic.​code Base example Not State Unknown
Group.characteristic.​value[x] Base example Not State Unknown

Constraints

Id Grade Path(s) Description Expression
dom-2 error Group If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Group If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Group If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Group If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Group A resource should have narrative for robust management text.`div`.exists()
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()
grp-1 error Group Can only have members if group is "actual" member.empty() or (actual = true)

This structure is derived from Group

Summary

Must-Support: 10 elements
Fixed: 2 elements
Prohibited: 1 element

Structures

This structure refers to these other structures:

 

Other representations of profile: CSV, Excel, Schematron