Artifact use context - FHIR Extensions Pack v5.4.0

FHIR Extensions Pack
5.4.0 - May 2026 International flag

FHIR Extensions Pack, published by HL7 International / FHIR Infrastructure. This guide is not an authorized publication; it is the continuous build for version 5.4.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-extensions/ and changes regularly. See the Directory of published versions

Extension: Artifact use context

Official URL: http://hl7.org/fhir/StructureDefinition/artifact-useContext		Version: 5.4.0	Highlight text changes?
Standards status: Trial-use	Maturity Level: 2	Responsible: HL7 International / Clinical Decision Support	Computable Name: ArtifactUseContext
Other Identifiers: OID:2.16.840.1.113883.4.642.5.1761

The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, …) or may be references to specific programs (insurance plans, studies, …) and may be used to assist with indexing and searching for appropriate artifact instances.

Context of Use

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

Element ID: ArtifactAssessment (FHIR versions R5 and after)
Element ID: ClinicalUseDefinition (FHIR versions R4B and after)
Element ID: Composition (FHIR versions up to R4B )
Element ID: ConditionDefinition (FHIR versions R5 and after)
Element ID: DeviceDefinition (FHIR versions R4 and after)
Element ID: Group
Element ID: Medication
Element ID: MedicationKnowledge (FHIR versions R4 and after)
Element ID: ObservationDefinition (FHIR versions R4 and after)
Element ID: ResearchStudy
Element ID: SpecimenDefinition (FHIR versions R4 and after)
Element ID: Substance
Element ID: SubstanceDefinition (FHIR versions R4B and after)
Element ID: SubscriptionTopic (FHIR versions R4B and after)

Usage info

Usages:

This Extension is not used by any profiles in this Specification

You can also check for usages in the FHIR IG Statistics

Changes since version 5.3.0:

No changes

Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

Text Summary
Differential Table
Snapshot Table
All

This structure is derived from Extension

Summary

Simple Extension with the type UsageContext: The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate artifact instances.

Maturity: 2

This structure is derived from Extension

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension	0..*	Extension	The context that the content is intended to support
Extension.extension	0..0		Extension
Extension.url	1..1	uri	"http://hl7.org/fhir/StructureDefinition/artifact-useContext"
Extension.value[x]	1..1	UsageContext	Value of extension
Documentation for this format

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension	0..*	Extension	The context that the content is intended to support
Extension.id	0..1	id	Unique id for inter-element referencing
Extension.extension	0..0		Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.url	1..1	uri	"http://hl7.org/fhir/StructureDefinition/artifact-useContext"
Extension.value[x]	1..1	UsageContext	Value of extension
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type UsageContext: The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate artifact instances.

Maturity: 2

Differential View

This structure is derived from Extension

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension	0..*	Extension	The context that the content is intended to support
Extension.extension	0..0		Extension
Extension.url	1..1	uri	"http://hl7.org/fhir/StructureDefinition/artifact-useContext"
Extension.value[x]	1..1	UsageContext	Value of extension
Documentation for this format

Snapshot View

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension	0..*	Extension	The context that the content is intended to support
Extension.id	0..1	id	Unique id for inter-element referencing
Extension.extension	0..0		Extension Slice: Unordered, Open by value:url Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Extension.url	1..1	uri	"http://hl7.org/fhir/StructureDefinition/artifact-useContext"
Extension.value[x]	1..1	UsageContext	Value of extension
Documentation for this format

Other representations of profile: CSV, Excel, Schematron

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()`

R4B

The extension is represented a little differently in R4B:

Remove the extension context ArtifactAssessment (not for this version)
Remove the extension context ConditionDefinition (not for this version)
Note: Extensions that have been modified for R4B are still draft while real-world experience is collected

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension	0..*	Extension	The context that the content is intended to support
Extension. extension	0 .. 0		Extension
Extension. url	1 .. 1	uri	"http://hl7.org/fhir/StructureDefinition/artifact-useContext"
Extension. value[x]	1.. 1	UsageContext	Value of extension
Documentation for this format

R4

The extension is represented a little differently in R4:

Remove the extension context ArtifactAssessment (not for this version)
Remove the extension context ClinicalUseDefinition (not for this version)
Remove the extension context ConditionDefinition (not for this version)
Remove the extension context SubstanceDefinition (not for this version)
Remove the extension context SubscriptionTopic (not for this version)
Note: Extensions that have been modified for R4 are still draft while real-world experience is collected

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension	0..*	Extension	The context that the content is intended to support
Extension. extension	0 .. 0		Extension
Extension. url	1 .. 1	uri	"http://hl7.org/fhir/StructureDefinition/artifact-useContext"
Extension. value[x]	1.. 1	UsageContext	Value of extension
Documentation for this format

R3

The extension is represented a little differently in R3:

Remove the extension context ArtifactAssessment (not for this version)
Remove the extension context ClinicalUseDefinition (not for this version)
Remove the extension context ConditionDefinition (not for this version)
Remove the extension context DeviceDefinition (not for this version)
Remove the extension context MedicationKnowledge (not for this version)
Remove the extension context ObservationDefinition (not for this version)
Remove the extension context SpecimenDefinition (not for this version)
Remove the extension context SubstanceDefinition (not for this version)
Remove the extension context SubscriptionTopic (not for this version)
Replace the type UsageContext with a set of extensions for the content of the type along with the _datatype extension
Note: Extensions that have been modified for R3 are still draft while real-world experience is collected

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension	0..*	Extension	The context that the content is intended to support
Extension. Slices for extension	0 ..*	Extension	Extension Slice: Unordered, Open by value:url
Extension.Slices for extension. extension:_datatype	1..1	(Complex)	DataType name 'UsageContext' from R5 URL: http://hl7.org/fhir/StructureDefinition/_datatype
Extension.Slices for extension.extension:_datatype. value[x]	1.. 1	string	Value of extension Fixed Value: UsageContext
Extension.Slices for extension. extension:code	1..1	Extension	Type of context being specified
Extension.Slices for extension.extension:code. extension	0 .. 0		Extension
Extension.Slices for extension.extension:code. url	1 .. 1	uri	"code"
Extension.Slices for extension.extension:code. value[x]	1.. 1	Coding	Value of extension Binding: UsageContextType ( extensible ) : A code that specifies a type of context being specified by a usage context.
Extension.Slices for extension. extension:value[x]	1..1	Extension	Value that defines the context
Extension.Slices for extension.extension:value[x]. extension	0 .. 0		Extension
Extension.Slices for extension.extension:value[x]. url	1 .. 1	uri	"value[x]"
Extension.Slices for extension.extension:value[x]. value[x]	1.. 1		Value of extension Binding: ContextOfUseValueSet ( example ) : A code that defines the specific value for the context being specified.
Extension.Slices for extension.extension:value[x].value[x]. valueCodeableConcept		CodeableConcept
Extension.Slices for extension.extension:value[x].value[x]. valueQuantity		Quantity
Extension.Slices for extension.extension:value[x].value[x]. valueRange		Range
Extension.Slices for extension.extension:value[x].value[x]. valueReference		Reference ( PlanDefinition \| ResearchStudy \| InsurancePlan \| HealthcareService \| Group \| Location \| Organization )
Extension. url	1 .. 1	uri	"http://hl7.org/fhir/StructureDefinition/artifact-useContext"
Extension. value[x]	0 .. 0		Value of extension
Documentation for this format