DosageDetails
type: StructureDefinition
node role: treeRoot
id:
  v: DosageDetails
text:
  status:
    v: generated
  div:
    v: Name Flags Card. Type Description & Constraints<img src="[binary]" alt="doco" style="background-color: inherit"/> <img src="[binary]" alt="." style="background-color: white; background-color: inherit" title="Element" class="hierarchy"/> DosageDetails ΣN Element How the medication is/was taken or should be taken + Rule: If only one step is present, DosageDetails.step.safety shall not be populated Elements defined in Ancestors: id, <a href="types.html#Element" title="May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.">extension, <a href="types.html#BackboneType" title="May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.#xA;#xA;Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).">modifierExtension #xD; renderedInstruction Σ 1..1 markdown Full representation of the dosage instructions #xD; <img src="[binary]" alt="." style="background-color: white; background-color: inherit" title="Element" class="hierarchy"/> step Σ 0..* Element One ste…
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status
    l: structuredefinition-standards-status
  value: Code
    v: normative
extension:
  url:
    v: http://hl7.org/fhir/StructureDefinition/structuredefinition-wg
    l: structuredefinition-wg
  value: Code
    v: fhir
url:
  v: http://hl7.org/fhir/StructureDefinition/DosageDetails
  l: DosageDetails
version:
  v: 6.0.0-ballot4
name:
  v: DosageDetails
status:
  v: active
experimental:
  v: false
date:
  v: 2026-06-09T18:27:56+00:00
publisher:
  v: HL7 International / FHIR Infrastructure
contact:
  telecom:
    system:
      v: url
    value:
      v: http://hl7.org/fhir
contact:
  telecom:
    system:
      v: url
    value:
      v: http://www.hl7.org/Special/committees/fiwg
description:
  v: DosageDetails Type: Indicates how the medication is/was taken or should be taken by the patient.
jurisdiction:
  coding:
    system:
      v: http://unstats.un.org/unsd/methods/m49/m49.htm
      l: m49.htm
    code:
      v: 001
    display:
      v: World
fhir version:
  v: 6.0.0-ballot4
mapping:
  identity:
    v: rim
  uri:
    v: http://hl7.org/v3
    l: v3
  name:
    v: RIM Mapping
kind:
  v: complex-type
abstract:
  v: false
type:
  v: DosageDetails
  l: DosageDetails
base definition:
  v: http://hl7.org/fhir/StructureDefinition/BackboneType
  l: BackboneType
derivation:
  v: specialization
snapshot:
  element:
    id:
      v: DosageDetails
    path:
      v: DosageDetails
    short:
      v: How the medication is/was taken or should be taken
    definition:
      v: Indicates how the medication is/was taken or should be taken by the patient.
    min:
      v: 0
    max:
      v: *
    base:
      path:
        v: DosageDetails
      min:
        v: 0
      max:
        v: *
    constraint:
      key:
        v: dosdet-2
      severity:
        v: error
      human:
        v: If only one step is present, DosageDetails.step.safety shall not be populated
      expression:
        v: step.count() = 1 implies step.safety.empty()
      source:
        v: http://hl7.org/fhir/StructureDefinition/DosageDetails
        l: DosageDetails
    constraint:
      key:
        v: ele-1
      severity:
        v: error
      human:
        v: All FHIR elements must have a @value or children
      expression:
        v: hasValue() or (children().count() > id.count())
      source:
        v: http://hl7.org/fhir/StructureDefinition/Element
        l: Element
    is modifier:
      v: false
    mapping:
      identity:
        v: rim
      map:
        v: n/a
  element:
    id:
      v: DosageDetails.id
    path:
      v: DosageDetails.id
    representation:
      v: xmlAttr
    short:
      v: Unique id for inter-element referencing
    definition:
      v: Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
    min:
      v: 0
    max:
      v: 1
    base:
      path:
        v: Element.id
      min:
        v: 0
      max:
        v: 1
    type:
      extension:
        value: Url
      code:
        v: http://hl7.org/fhirpath/System.String
        l: System.String
    condition:
      v: ele-1
    is modifier:
      v: false
    is summary:
      v: false
    mapping:
      identity:
        v: rim
      map:
        v: n/a
  element:
    id:
      v: DosageDetails.extension
    path:
      v: DosageDetails.extension
    slicing:
      description:
        v: Extensions are always sliced by (at least) url
      rules:
        v: open
    short:
      v: Additional content defined by implementations
    definition:
      v: May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
    comment:
      v: There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
    alias:
      v: extensions
    alias:
      v: user content
    min:
      v: 0
    max:
      v: *
    base:
      path:
        v: Element.extension
      min:
        v: 0
      max:
        v: *

Url
v: string
l: string

v: value

v: url

code:
  v: Extension
  l: Extension

key:
  v: ele-1
severity:
  v: error
human:
  v: All FHIR elements must have a @value or children
expression:
  v: hasValue() or (children().count() > id.count())
source:
  v: http://hl7.org/fhir/StructureDefinition/Element
  l: Element

v: false

v: false

identity:
  v: rim
map:
  v: n/a

id:
  v: DosageDetails.modifierExtension
path:
  v: DosageDetails.modifierExtension
short:
  v: Extensions that cannot be ignored even if unrecognized
definition:
  v: May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
comment:
  v: There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
requirements:
  v: Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](extensibility.html#modifierExtension).
alias:
  v: extensions
alias:
  v: user content
alias:
  v: modifiers
min:
  v: 0
max:
  v: *
base:
  path:
    v: BackboneType.modifierExtension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: true
is modifier reason:
  v: Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
is summary:
  v: true
mapping:
  identity:
    v: rim
  map:
    v: N/A

id:
  v: DosageDetails.renderedInstruction
path:
  v: DosageDetails.renderedInstruction
short:
  v: Full representation of the dosage instructions
definition:
  v: The full representation of the dose of the medication included in all dosage instructions. The renderedInstructions element must always be present to ensure the full dosage intent is communicated in every case.
comment:
  v: The content of the renderedInstructions SHALL contain the information found in the structured dosage, and may contain additional information not found in the structured dosage content, if applicable.
min:
  v: 1
max:
  v: 1
base:
  path:
    v: DosageDetails.renderedInstruction
  min:
    v: 1
  max:
    v: 1
type:
  code:
    v: markdown
    l: markdown
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true

id:
  v: DosageDetails.step
path:
  v: DosageDetails.step
short:
  v: One step in a sequence of steps that comprise the dosage course
definition:
  v: One step in a sequence of steps that comprise the dosage course.
min:
  v: 0
max:
  v: *
base:
  path:
    v: DosageDetails.step
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Element
    l: Element
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children or both
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true

id:
  v: DosageDetails.step.id
path:
  v: DosageDetails.step.id
representation:
  v: xmlAttr
short:
  v: Unique id for inter-element referencing
definition:
  v: Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: Element.id
  min:
    v: 0
  max:
    v: 1
type:
  extension:
    url:
      v: http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type
      l: structuredefinition-fhir-type
    value: Url
      v: string
      l: string
  code:
    v: http://hl7.org/fhirpath/System.String
    l: System.String
condition:
  v: ele-1
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: DosageDetails.step.extension
path:
  v: DosageDetails.step.extension
slicing:
  discriminator:
    type:
      v: value
    path:
      v: url
  description:
    v: Extensions are always sliced by (at least) url
  rules:
    v: open
short:
  v: Additional content defined by implementations
definition:
  v: May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
comment:
  v: There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
alias:
  v: extensions
alias:
  v: user content
min:
  v: 0
max:
  v: *
base:
  path:
    v: Element.extension
  min:
    v: 0
  max:
    v: *
type:
  code:
    v: Extension
    l: Extension
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: false
mapping:
  identity:
    v: rim
  map:
    v: n/a

id:
  v: DosageDetails.step.start
path:
  v: DosageDetails.step.start
short:
  v: When the step starts
definition:
  v: When the step starts. In the absence of a linked event, the step is assumed to start immediately (or after the previous step).
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DosageDetails.step.start
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: RelativeTime
    l: RelativeTime
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true

id:
  v: DosageDetails.step.end
path:
  v: DosageDetails.step.end
short:
  v: When the step ends
definition:
  v: When the step ends. In the absence of a linked event, the step is assumed to end when the internal timing schedule termnates.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DosageDetails.step.end
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: RelativeTime
    l: RelativeTime
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true

id:
  v: DosageDetails.step.count
path:
  v: DosageDetails.step.count
short:
  v: How many times to do this step (if not 1)
definition:
  v: How many times to do this step (if not 1).
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DosageDetails.step.count
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: integer
    l: integer
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true

id:
  v: DosageDetails.step.component
path:
  v: DosageDetails.step.component
short:
  v: A dosage details that is part of this step
definition:
  v: A dosage details that is part of this step.
min:
  v: 1
max:
  v: *
base:
  path:
    v: DosageDetails.step.component
  min:
    v: 1
  max:
    v: *
type:
  code:
    v: Dosage
    l: Dosage
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true

id:
  v: DosageDetails.step.safety
path:
  v: DosageDetails.step.safety
short:
  v: Safety Information about this step of the dose course
definition:
  v: Safety Information about this step of the dose course.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DosageDetails.step.safety
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: DosageSafety
    l: DosageSafety
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true

id:
  v: DosageDetails.safety
path:
  v: DosageDetails.safety
short:
  v: Safety Information about the combined dose course
definition:
  v: Safety Information about the combined dose course.
min:
  v: 0
max:
  v: 1
base:
  path:
    v: DosageDetails.safety
  min:
    v: 0
  max:
    v: 1
type:
  code:
    v: DosageSafety
    l: DosageSafety
constraint:
  key:
    v: ele-1
  severity:
    v: error
  human:
    v: All FHIR elements must have a @value or children
  expression:
    v: hasValue() or (children().count() > id.count())
  source:
    v: http://hl7.org/fhir/StructureDefinition/Element
    l: Element
is modifier:
  v: false
is summary:
  v: true

element:
  id:
    v: DosageDetails
  path:
    v: DosageDetails
  short:
    v: How the medication is/was taken or should be taken
  definition:
    v: Indicates how the medication is/was taken or should be taken by the patient.
  min:
    v: 0
  max:
    v: *
  constraint:
    key:
      v: dosdet-2
    severity:
      v: error
    human:
      v: If only one step is present, DosageDetails.step.safety shall not be populated
    expression:
      v: step.count() = 1 implies step.safety.empty()
    source:
      v: http://hl7.org/fhir/StructureDefinition/DosageDetails
      l: DosageDetails
element:
  id:
    v: DosageDetails.renderedInstruction
  path:
    v: DosageDetails.renderedInstruction
  short:
    v: Full representation of the dosage instructions
  definition:
    v: The full representation of the dose of the medication included in all dosage instructions. The renderedInstructions element must always be present to ensure the full dosage intent is communicated in every case.
  comment:
    v: The content of the renderedInstructions SHALL contain the information found in the structured dosage, and may contain additional information not found in the structured dosage content, if applicable.
  min:
    v: 1
  max:
    v: 1
  type:
    code:
      v: markdown
      l: markdown
  is summary:
    v: true
element:
  id:
    v: DosageDetails.step
  path:
    v: DosageDetails.step
  short:
    v: One step in a sequence of steps that comprise the dosage course
  definition:
    v: One step in a sequence of steps that comprise the dosage course.
  min:
    v: 0
  max:
    v: *
  type:
    code:
      v: Element
      l: Element
  is summary:
    v: true
element:
  id:
    v: DosageDetails.step.start
  path:
    v: DosageDetails.step.start
  short:
    v: When the step starts
  definition:
    v: When the step starts. In the absence of a linked event, the step is assumed to start immediately (or after the previous step).
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: RelativeTime
      l: RelativeTime
  is summary:
    v: true
element:
  id:
    v: DosageDetails.step.end
  path:
    v: DosageDetails.step.end
  short:
    v: When the step ends
  definition:
    v: When the step ends. In the absence of a linked event, the step is assumed to end when the internal timing schedule termnates.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: RelativeTime
      l: RelativeTime
  is summary:
    v: true
element:
  id:
    v: DosageDetails.step.count
  path:
    v: DosageDetails.step.count
  short:
    v: How many times to do this step (if not 1)
  definition:
    v: How many times to do this step (if not 1).
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: integer
      l: integer
  is summary:
    v: true
element:
  id:
    v: DosageDetails.step.component
  path:
    v: DosageDetails.step.component
  short:
    v: A dosage details that is part of this step
  definition:
    v: A dosage details that is part of this step.
  min:
    v: 1
  max:
    v: *
  type:
    code:
      v: Dosage
      l: Dosage
  is summary:
    v: true
element:
  id:
    v: DosageDetails.step.safety
  path:
    v: DosageDetails.step.safety
  short:
    v: Safety Information about this step of the dose course
  definition:
    v: Safety Information about this step of the dose course.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: DosageSafety
      l: DosageSafety
  is summary:
    v: true
element:
  id:
    v: DosageDetails.safety
  path:
    v: DosageDetails.safety
  short:
    v: Safety Information about the combined dose course
  definition:
    v: Safety Information about the combined dose course.
  min:
    v: 0
  max:
    v: 1
  type:
    code:
      v: DosageSafety
      l: DosageSafety
  is summary:
    v: true