---
type: "resource"
title: "ConditionDefinition"
resource: "ConditionDefinition"
---
# ConditionDefinition


## Introduction


## Scope and Usage

A condition definition defines a set of system properties for a particular condition.

It is important to understand the condition definition resource is not intended to be used to define the underlying biological or ontological basis for the condition; instead the focus is on how the condition is identified, managed, and treated.

## Boundaries and Relationships

-   Conditions may have a matching condition definition, but need not do so
-   Condition definitions may identify observations and signs (including, but not limited to) lab tests that are indicative of the condition
-   Condition definitions often identify ongoing observations to prioritize when viewing the chart of patients with the conditions
-   Condition definitions may identify applicable care plans

## Background and Context

One frequent criticism of information systems in healthcare is that they do not adapt well to changing context, particularly the context of what is specifically wrong. A typical institution will have 20-30,000 different kinds of observational data, but only a small portion of these are relevant to any particular condition. Information systems supporting clinical care provision are increasingly investigating the use of AI, but ConditionDefinition provides a simple way to help the system be more adaptive.

## StructureDefinition

### Elements (Simplified)

- **[ConditionDefinition](/conditiondefinition-definitions#ConditionDefinition)** [0..*]: - A definition of a condition
- **[ConditionDefinition.url](/conditiondefinition-definitions#ConditionDefinition.url)** [0..1]: [uri](/uri) Canonical identifier for this condition definition, represented as a URI (globally unique)
- **[ConditionDefinition.identifier](/conditiondefinition-definitions#ConditionDefinition.identifier)** [0..*]: [Identifier](/Identifier) Additional identifier for the condition definition
- **[ConditionDefinition.version](/conditiondefinition-definitions#ConditionDefinition.version)** [0..1]: [string](/string) Business version of the condition definition
- **[ConditionDefinition.versionAlgorithm[x]](/conditiondefinition-definitions#ConditionDefinition.versionAlgorithm%5Bx%5D)** [0..1]: [string](/string), [Coding](/Coding) extensible:[version-algorithm](/valueset-version-algorithm) How to compare versions
- **[ConditionDefinition.name](/conditiondefinition-definitions#ConditionDefinition.name)** [0..1]: [string](/string) Name for this condition definition (computer friendly)
- **[ConditionDefinition.title](/conditiondefinition-definitions#ConditionDefinition.title)** [0..1]: [string](/string) Name for this condition definition (human friendly)
- **[ConditionDefinition.subtitle](/conditiondefinition-definitions#ConditionDefinition.subtitle)** [0..1]: [string](/string) Subordinate title of the event definition
- **[ConditionDefinition.status](/conditiondefinition-definitions#ConditionDefinition.status)** [1..1]: [code](/code) required:[publication-status](/valueset-publication-status) draft | active | retired | unknown
- **[ConditionDefinition.experimental](/conditiondefinition-definitions#ConditionDefinition.experimental)** [0..1]: [boolean](/boolean) For testing only - never for real usage
- **[ConditionDefinition.date](/conditiondefinition-definitions#ConditionDefinition.date)** [0..1]: [dateTime](/dateTime) Date last changed
- **[ConditionDefinition.publisher](/conditiondefinition-definitions#ConditionDefinition.publisher)** [0..1]: [string](/string) Name of the publisher/steward (organization or individual)
- **[ConditionDefinition.contact](/conditiondefinition-definitions#ConditionDefinition.contact)** [0..*]: [ContactDetail](/ContactDetail) Contact details for the publisher
- **[ConditionDefinition.description](/conditiondefinition-definitions#ConditionDefinition.description)** [0..1]: [markdown](/markdown) Natural language description of the condition definition
- **[ConditionDefinition.useContext](/conditiondefinition-definitions#ConditionDefinition.useContext)** [0..*]: [UsageContext](/UsageContext) The context that the content is intended to support
- **[ConditionDefinition.jurisdiction](/conditiondefinition-definitions#ConditionDefinition.jurisdiction)** [0..*]: [CodeableConcept](/CodeableConcept) extensible:[jurisdiction](/valueset-jurisdiction) Jurisdiction of the authority that maintains the condition definition (if applicable)
- **[ConditionDefinition.code](/conditiondefinition-definitions#ConditionDefinition.code)** [1..1]: [CodeableConcept](/CodeableConcept) example:[condition-code](/valueset-condition-code) Identification of the condition, problem or diagnosis
- **[ConditionDefinition.severity](/conditiondefinition-definitions#ConditionDefinition.severity)** [0..1]: [CodeableConcept](/CodeableConcept) preferred:[condition-severity](/valueset-condition-severity) Subjective severity of condition
- **[ConditionDefinition.bodySite](/conditiondefinition-definitions#ConditionDefinition.bodySite)** [0..1]: [CodeableConcept](/CodeableConcept) example:[body-site](/valueset-body-site) Anatomical location, if relevant
- **[ConditionDefinition.stage](/conditiondefinition-definitions#ConditionDefinition.stage)** [0..1]: [CodeableConcept](/CodeableConcept) example:[condition-stage](/valueset-condition-stage) Stage/grade, usually assessed formally
- **[ConditionDefinition.hasSeverity](/conditiondefinition-definitions#ConditionDefinition.hasSeverity)** [0..1]: [boolean](/boolean) Whether Severity is appropriate
- **[ConditionDefinition.hasBodySite](/conditiondefinition-definitions#ConditionDefinition.hasBodySite)** [0..1]: [boolean](/boolean) Whether bodySite is appropriate
- **[ConditionDefinition.hasStage](/conditiondefinition-definitions#ConditionDefinition.hasStage)** [0..1]: [boolean](/boolean) Whether stage is appropriate
- **[ConditionDefinition.definition](/conditiondefinition-definitions#ConditionDefinition.definition)** [0..*]: [uri](/uri) Formal Definition for the condition
- **[ConditionDefinition.observation](/conditiondefinition-definitions#ConditionDefinition.observation)** [0..*]: [canonical](/canonical) Observations particularly relevant to this condition
- **[ConditionDefinition.medication](/conditiondefinition-definitions#ConditionDefinition.medication)** [0..*]: [BackboneElement](/BackboneElement) Medications particularly relevant for this condition
- **[ConditionDefinition.medication.category](/conditiondefinition-definitions#ConditionDefinition.medication.category)** [0..1]: [CodeableConcept](/CodeableConcept) example:[medicationrequest-category](/valueset-medicationrequest-category) Category that is relevant
- **[ConditionDefinition.medication.code](/conditiondefinition-definitions#ConditionDefinition.medication.code)** [0..1]: [CodeableConcept](/CodeableConcept) example:[medication-codes](/valueset-medication-codes) Code for relevant Medication
- **[ConditionDefinition.precondition](/conditiondefinition-definitions#ConditionDefinition.precondition)** [0..*]: [BackboneElement](/BackboneElement) Observation that suggets this condition
- **[ConditionDefinition.precondition.type](/conditiondefinition-definitions#ConditionDefinition.precondition.type)** [1..1]: [code](/code) required:[condition-precondition-type](/valueset-condition-precondition-type) sensitive | specific
- **[ConditionDefinition.precondition.code](/conditiondefinition-definitions#ConditionDefinition.precondition.code)** [1..1]: [CodeableConcept](/CodeableConcept) example:[observation-codes](/valueset-observation-codes) Code for relevant Observation
- **[ConditionDefinition.precondition.value[x]](/conditiondefinition-definitions#ConditionDefinition.precondition.value%5Bx%5D)** [0..1]: [CodeableConcept](/CodeableConcept), [Quantity](/Quantity) Value of Observation
- **[ConditionDefinition.team](/conditiondefinition-definitions#ConditionDefinition.team)** [0..*]: Reference([CareTeam](/CareTeam)) Appropriate team for this condition
- **[ConditionDefinition.questionnaire](/conditiondefinition-definitions#ConditionDefinition.questionnaire)** [0..*]: [BackboneElement](/BackboneElement) Questionnaire for this condition
- **[ConditionDefinition.questionnaire.purpose](/conditiondefinition-definitions#ConditionDefinition.questionnaire.purpose)** [1..1]: [code](/code) required:[condition-questionnaire-purpose](/valueset-condition-questionnaire-purpose) preadmit | diff-diagnosis | outcome
- **[ConditionDefinition.questionnaire.reference](/conditiondefinition-definitions#ConditionDefinition.questionnaire.reference)** [1..1]: Reference([Questionnaire](/Questionnaire)) Specific Questionnaire
- **[ConditionDefinition.plan](/conditiondefinition-definitions#ConditionDefinition.plan)** [0..*]: [BackboneElement](/BackboneElement) Plan that is appropriate
- **[ConditionDefinition.plan.role](/conditiondefinition-definitions#ConditionDefinition.plan.role)** [0..1]: [CodeableConcept](/CodeableConcept) Use for the plan
- **[ConditionDefinition.plan.reference](/conditiondefinition-definitions#ConditionDefinition.plan.reference)** [1..1]: Reference([PlanDefinition](/PlanDefinition)) The actual plan

## Mappings

- [ConditionDefinition Mappings](/conditiondefinition-mappings) — 9 mapping entries

## Resource Packs


### list-ConditionDefinition-packs.xml



```xml
<?xml version="1.0" encoding="UTF-8"?>

<List xmlns="http://hl7.org/fhir" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://hl7.org/fhir ../../publish/List.xsd">
  <id value="ConditionDefinition-packs"/>
  <status value="current"/>
  <mode value="working"/>
</List>
```


## Search Parameters

- [context](/conditiondefinition-search#context) — **token** — A use context assigned to the condition definition — `(ConditionDefinition.useContext.value.ofType(CodeableConcept))`
- [context-quantity](/conditiondefinition-search#context-quantity) — **quantity** — A quantity- or range-valued use context assigned to the condition definition — `(ConditionDefinition.useContext.value.ofType(Quantity)) | (ConditionDefinition.useContext.value.ofType(Range))`
- [context-type](/conditiondefinition-search#context-type) — **token** — A type of use context assigned to the condition definition — `ConditionDefinition.useContext.code`
- [context-type-quantity](/conditiondefinition-search#context-type-quantity) — **composite** — A use context type and quantity- or range-based value assigned to the condition definition — `ConditionDefinition.useContext`
- [context-type-value](/conditiondefinition-search#context-type-value) — **composite** — A use context type and value assigned to the condition definition — `ConditionDefinition.useContext`
- [date](/conditiondefinition-search#date) — **date** — The condition definition publication date — `ConditionDefinition.date`
- [description](/conditiondefinition-search#description) — **string** — The description of the condition definition — `ConditionDefinition.description`
- [identifier](/conditiondefinition-search#identifier) — **token** — External identifier for the condition definition — `ConditionDefinition.identifier`
- [jurisdiction](/conditiondefinition-search#jurisdiction) — **token** — Jurisdiction of the authority that maintains the the condition definition — `ConditionDefinition.jurisdiction`
- [name](/conditiondefinition-search#name) — **string** — Computationally friendly name of the condition definition — `ConditionDefinition.name`
- [publisher](/conditiondefinition-search#publisher) — **string** — Name of the publisher of the condition definition — `ConditionDefinition.publisher`
- [status](/conditiondefinition-search#status) — **token** — The current status of the condition definition — `ConditionDefinition.status`
- [title](/conditiondefinition-search#title) — **string** — The human-friendly name of the condition definition — `ConditionDefinition.title`
- [url](/conditiondefinition-search#url) — **uri** — The uri that identifies the condition definition — `ConditionDefinition.url`
- [version](/conditiondefinition-search#version) — **token** — The business version of the condition definition — `ConditionDefinition.version`

[Full Search Parameters](/conditiondefinition-search)

## Examples

- [conditiondefinition-example](/conditiondefinition-example-conditiondefinition-example) — conditiondefinition-example
- [conditiondefinition-examples-header](/conditiondefinition-example-conditiondefinition-examples-header) — conditiondefinition-examples-header
- [example](/conditiondefinition-example-example) — conditiondefinition-example — Example of conditiondefinition

[Full Examples](/conditiondefinition-examples)

## Mapping Exceptions


### conditiondefinition-fivews-mapping-exceptions.xml

### Unmapped Elements
- **FiveWs.what** — Unknown
- **FiveWs.author** — Unknown
- **FiveWs.actor** — Unknown
- **FiveWs.cause** — Unknown
- **FiveWs.where** — Unknown
- **FiveWs.context** — Unknown
- **FiveWs.init** — Unknown
- **FiveWs.why** — Unknown
- **FiveWs.source** — Unknown
- **FiveWs.who** — Unknown
- **FiveWs.grade** — Unknown
- **FiveWs.planned** — Unknown
- **FiveWs.done** — Unknown
- **FiveWs.subject** — Unknown