> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metriport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlanDefinition

> This resource allows for the definition of various types of plans as a sharable, consumable, and executable artifact. The resource is general enough to support the description of a broad range of clinical artifacts such as clinical decision support rules, order sets and protocols.

## Properties

| Name | Required | Type | Description |
| - | - | - | - |
| url | No | uri | Canonical identifier for this plan definition, represented as a URI (globally unique) |
| identifier | No | [Identifier](/medical-api/fhir/data-types/identifier)\[] | Additional identifier for the plan definition |
| version | No | string | Business version of the plan definition |
| name | No | string | Name for this plan definition (computer friendly) |
| title | No | string | Name for this plan definition (human friendly) |
| subtitle | No | string | Subordinate title of the plan definition |
| type | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | order-set / clinical-protocol / eca-rule / workflow-definition |
| status | Yes | code | draft / active / retired / unknown |
| experimental | No | boolean | For testing purposes, not real usage |
| subject\[x] | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept), Reference\<[Group](/medical-api/fhir/resources/group)> | Type of individual the plan definition is focused on |
| date | No | dateTime | Date last changed |
| publisher | No | string | Name of the publisher (organization or individual) |
| contact | No | [ContactDetail](/medical-api/fhir/data-types/contactdetail)\[] | Contact details for the publisher |
| description | No | markdown | Natural language description of the plan definition |
| useContext | No | [UsageContext](/medical-api/fhir/data-types/usagecontext)\[] | The context that the content is intended to support |
| jurisdiction | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[] | Intended jurisdiction for plan definition (if applicable) |
| purpose | No | markdown | Why this plan definition is defined |
| usage | No | string | Describes the clinical usage of the plan |
| copyright | No | markdown | Use and/or publishing restrictions |
| approvalDate | No | date | When the plan definition was approved by publisher |
| lastReviewDate | No | date | When the plan definition was last reviewed |
| effectivePeriod | No | [Period](/medical-api/fhir/data-types/period) | When the plan definition is expected to be used |
| topic | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[] | E.g. Education, Treatment, Assessment |
| author | No | [ContactDetail](/medical-api/fhir/data-types/contactdetail)\[] | Who authored the content |
| editor | No | [ContactDetail](/medical-api/fhir/data-types/contactdetail)\[] | Who edited the content |
| reviewer | No | [ContactDetail](/medical-api/fhir/data-types/contactdetail)\[] | Who reviewed the content |
| endorser | No | [ContactDetail](/medical-api/fhir/data-types/contactdetail)\[] | Who endorsed the content |
| relatedArtifact | No | [RelatedArtifact](/medical-api/fhir/data-types/relatedartifact)\[] | Additional documentation, citations |
| library | No | canonical\[] | Logic used by the plan definition |
| goal | No | PlanDefinitionGoal | What the plan is trying to accomplish |
| - id | No | string | Unique id for inter-element referencing |
| - extension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations |
| - modifierExtension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored even if unrecognized |
| - category | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | E.g. Treatment, dietary, behavioral |
| - description | Yes | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | Code or text describing the goal |
| - priority | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | high-priority / medium-priority / low-priority |
| - start | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | When goal pursuit begins |
| - addresses | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[] | What does the goal address |
| - documentation | No | [RelatedArtifact](/medical-api/fhir/data-types/relatedartifact)\[] | Supporting documentation for the goal |
| - target | No | PlanDefinitionGoalTarget | Target outcome for the goal |
| - id | No | string | Unique id for inter-element referencing |
| - extension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations |
| - modifierExtension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored even if unrecognized |
| - measure | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | The parameter whose value is to be tracked |
| - detail\[x] | No | [Quantity](/medical-api/fhir/data-types/quantity), [Range](/medical-api/fhir/data-types/range), [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | The target value to be achieved |
| - due | No | [Duration](/medical-api/fhir/data-types/duration) | Reach goal within |
| action | No | PlanDefinitionAction | Action defined by the plan |
| - id | No | string | Unique id for inter-element referencing |
| - extension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations |
| - modifierExtension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored even if unrecognized |
| - prefix | No | string | User-visible prefix for the action (e.g. 1. or A.) |
| - title | No | string | User-visible title |
| - description | No | string | Brief description of the action |
| - textEquivalent | No | string | Static text equivalent of the action, used if the dynamic aspects cannot be interpreted by the receiving system |
| - priority | No | code | routine / urgent / asap / stat |
| - code | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[] | Code representing the meaning of the action or sub-actions |
| - reason | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[] | Why the action should be performed |
| - documentation | No | [RelatedArtifact](/medical-api/fhir/data-types/relatedartifact)\[] | Supporting documentation for the intended performer of the action |
| - goalId | No | id\[] | What goals this action supports |
| - subject\[x] | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept), Reference\<[Group](/medical-api/fhir/resources/group)> | Type of individual the action is focused on |
| - trigger | No | [TriggerDefinition](/medical-api/fhir/data-types/triggerdefinition)\[] | When the action should be triggered |
| - condition | No | PlanDefinitionActionCondition | Whether or not the action is applicable |
| - id | No | string | Unique id for inter-element referencing |
| - extension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations |
| - modifierExtension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored even if unrecognized |
| - kind | Yes | code | applicability / start / stop |
| - expression | No | [Expression](/medical-api/fhir/data-types/expression) | Boolean-valued expression |
| - input | No | [DataRequirement](/medical-api/fhir/data-types/datarequirement)\[] | Input data requirements |
| - output | No | [DataRequirement](/medical-api/fhir/data-types/datarequirement)\[] | Output data definition |
| - relatedAction | No | PlanDefinitionActionRelatedAction | Relationship to another action |
| - id | No | string | Unique id for inter-element referencing |
| - extension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations |
| - modifierExtension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored even if unrecognized |
| - actionId | Yes | id | What action is this related to |
| - relationship | Yes | code | before-start / before / before-end / concurrent-with-start / concurrent / concurrent-with-end / after-start / after / after-end |
| - offset\[x] | No | [Duration](/medical-api/fhir/data-types/duration), [Range](/medical-api/fhir/data-types/range) | Time offset for the relationship |
| - timing\[x] | No | dateTime, [Age](/medical-api/fhir/data-types/age), [Period](/medical-api/fhir/data-types/period), [Duration](/medical-api/fhir/data-types/duration), [Range](/medical-api/fhir/data-types/range), [Timing](/medical-api/fhir/data-types/timing) | When the action should take place |
| - participant | No | PlanDefinitionActionParticipant | Who should participate in the action |
| - id | No | string | Unique id for inter-element referencing |
| - extension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations |
| - modifierExtension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored even if unrecognized |
| - type | Yes | code | patient / practitioner / related-person / device |
| - role | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | E.g. Nurse, Surgeon, Parent |
| - type | No | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept) | create / update / remove / fire-event |
| - groupingBehavior | No | code | visual-group / logical-group / sentence-group |
| - selectionBehavior | No | code | any / all / all-or-none / exactly-one / at-most-one / one-or-more |
| - requiredBehavior | No | code | must / could / must-unless-documented |
| - precheckBehavior | No | code | yes / no |
| - cardinalityBehavior | No | code | single / multiple |
| - definition\[x] | No | canonical, uri | Description of the activity to be performed |
| - transform | No | canonical | Transform to apply the template |
| - dynamicValue | No | PlanDefinitionActionDynamicValue | Dynamic aspects of the definition |
| - id | No | string | Unique id for inter-element referencing |
| - extension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations |
| - modifierExtension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored even if unrecognized |
| - path | No | string | The path to the element to be set dynamically |
| - expression | No | [Expression](/medical-api/fhir/data-types/expression) | An expression that provides the dynamic value for the customization |
| - action | No | \[] | A sub-action |

## Search Parameters

| Name | Type | Description | Expression |
| - | - | - | - |
| composed-of | reference | What resource is being referenced | PlanDefinition.relatedArtifact |
| context | token | A use context assigned to the plan definition | PlanDefinition.useContext.value |
| context-quantity | quantity | A quantity- or range-valued use context assigned to the plan definition | PlanDefinition.useContext.value |
| context-type | token | A type of use context assigned to the plan definition | PlanDefinition.useContext.code |
| date | date | The plan definition publication date | PlanDefinition.date |
| definition | reference | Activity or plan definitions used by plan definition | PlanDefinition.action.definition |
| depends-on | reference | What resource is being referenced | PlanDefinition.relatedArtifact |
| derived-from | reference | What resource is being referenced | PlanDefinition.relatedArtifact |
| description | string | The description of the plan definition | PlanDefinition.description |
| effective | date | The time during which the plan definition is intended to be in use | PlanDefinition.effectivePeriod |
| identifier | token | External identifier for the plan definition | PlanDefinition.identifier |
| jurisdiction | token | Intended jurisdiction for the plan definition | PlanDefinition.jurisdiction |
| name | string | Computationally friendly name of the plan definition | PlanDefinition.name |
| predecessor | reference | What resource is being referenced | PlanDefinition.relatedArtifact |
| publisher | string | Name of the publisher of the plan definition | PlanDefinition.publisher |
| status | token | The current status of the plan definition | PlanDefinition.status |
| successor | reference | What resource is being referenced | PlanDefinition.relatedArtifact |
| title | string | The human-friendly name of the plan definition | PlanDefinition.title |
| topic | token | Topics associated with the module | PlanDefinition.topic |
| type | token | The type of artifact the plan (e.g. order-set, eca-rule, protocol) | PlanDefinition.type |
| url | uri | The uri that identifies the plan definition | PlanDefinition.url |
| version | token | The business version of the plan definition | PlanDefinition.version |
| context-type-quantity | composite | A use context type and quantity- or range-based value assigned to the plan definition | PlanDefinition.useContext |
| context-type-value | composite | A use context type and value assigned to the plan definition | PlanDefinition.useContext |

## Inherited Properties

| Name | Required | Type | Description |
| - | - | - | - |
| id | No | string | Logical id of this artifact |
| meta | No | [Meta](/medical-api/fhir/data-types/meta) | Metadata about the resource |
| implicitRules | No | uri | A set of rules under which this content was created |
| language | No | code | Language of the resource content |
| text | No | [Narrative](/medical-api/fhir/data-types/narrative) | Text summary of the resource, for human interpretation |
| contained | No | Resource\[] | Contained, inline Resources |
| extension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations |
| modifierExtension | No | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored |

To view the FHIR specification for this resource, see [PlanDefinition](https://www.hl7.org/fhir/StructureDefinition/PlanDefinition).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.