FHIR Release 3 (STU) CI-Build

This page is part of the FHIR Specification (v3.0.2: STU 3). The current version which supercedes this version is 5.0.0 . For a full list Continuous Integration Build of available versions, see FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions . Page versions: R5 R4B R4 R3

Codesystem-concept-properties.xml

Example CodeSystem/concept-properties (XML)

Maturity Level : N/A
Responsible Owner: Vocabulary Terminology Infrastructure Work Group Ballot Standards Status : Informative

Raw XML ( canonical form + also see XML Format Specification )

Definition for Code System FHIR Defined Concept Properties SystemConceptProperties

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


      
      
      
        
          
            
          
          
            
          
          
            
          
        
        
          inactive
            
          
          
          True if the concept is not considered active - e.g. not a valid concept any more. Property
             type is boolean, default value is false
        
        
          deprecated
            
          
          
          The date at which a concept was deprecated. Concepts that are deprecated but not inactive
             can still be used, but their use is discouraged, and they should be expected to be made
             inactive in a future release. Property type is dateTime
        
        
          notSelectable
            
          
          
          The concept is not intended to be chosen by the user - only intended to be used as a selector
             for other concepts. Note, though, that the interpretation of this is highly contextual;
             all concepts are selectable in some context. Property type is boolean, default value is
             false
        
        
          parent
            
          
          
          The concept identified in this property is a parent of the concept on which it is a property.
             The property type will be 'code'. The meaning of 'parent' is defined by the hierarchyMeaning
             attribute
        
        
          child
            
          
          
          The concept identified in this property is a child of the concept on which it is a property.
             The property type will be 'code'. The meaning of 'child' is defined by the hierarchyMeaning
             attribute
        
      
    
  
  
    
  
  
    
  
  
  
  
  
  
  
  
  
  
    
    
    True if the concept is not considered active - e.g. not a valid concept any more. Property
     type is boolean, default value is false
  
  
    
    
    The date at which a concept was deprecated. Concepts that are deprecated but not inactive
     can still be used, but their use is discouraged, and they should be expected to be made
     inactive in a future release. Property type is dateTime
  
  
    
    
    The concept is not intended to be chosen by the user - only intended to be used as a selector
     for other concepts. Note, though, that the interpretation of this is highly contextual;
     all concepts are selectable in some context. Property type is boolean, default value is
     false
  
  
    
    
    The concept identified in this property is a parent of the concept on which it is a property.
     The property type will be 'code'. The meaning of 'parent' is defined by the hierarchyMeaning
     attribute
  
  
    
    
    The concept identified in this property is a child of the concept on which it is a property.
     The property type will be 'code'. The meaning of 'child' is defined by the hierarchyMeaning
     attribute
  

<CodeSystem xmlns="http://hl7.org/fhir">
  <id value="concept-properties"/> 
  <meta> 
    <lastUpdated value="2025-11-10T04:50:58.407+00:00"/> 
  </meta> 
  <text> 
    <status value="generated"/> 
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p class="res-header-id">
        <b> Generated Narrative: CodeSystem concept-properties</b> 
      </p> 
      <a name="concept-properties"> </a> 
      <a name="hcconcept-properties"> </a> 
      <p> 
        <b> Properties</b> 
      </p> 
      <p> 
        <b> This code system defines the following properties for its concepts</b> 
      </p> 
      <table class="grid">
        <tr> 
          <td> 
            <b> Name</b> 
          </td> 
          <td> 
            <b> Code</b> 
          </td> 
          <td> 
            <b> URI</b> 
          </td> 
          <td> 
            <b> Type</b> 
          </td> 
          <td> 
            <b> Description</b> 
          </td> 
          <td> 
            <b> Value Set</b> 
          </td> 
        </tr> 
        <tr> 
          <td> dataType</td> 
          <td> dataType</td> 
          <td> http://hl7.org/fhir/concept-properties#dataType</td> 
          <td> code</td> 
          <td> data type of property value</td> 
          <td/>  
        </tr> 
        <tr> 
          <td> Status</td> 
          <td> status</td> 
          <td> http://hl7.org/fhir/concept-properties#status</td> 
          <td> code</td> 
          <td> A code that indicates the status of the concept. Typical values are active, experimental,
             deprecated, and retired</td> 
          <td>             <a href="valueset-concept-property-type.html">Property Type</a>           </td>         </tr>       </table>       <p>         <b> Concepts</b>       </p>       <p> This case-sensitive code system         <code> http://hl7.org/fhir/concept-properties</code>  defines the following codes:      </p>       <table class="codes">        <tr>           <td style="white-space:nowrap">            <b> Code</b>           </td>           <td>             <b> Display</b>           </td>           <td>             <b> Definition</b>           </td>           <td>             <b> dataType</b>           </td>           <td>             <b> Status</b>           </td>         </tr>         <tr>           <td style="white-space:nowrap">status            <a name="concept-properties-status"> </a>           </td>           <td> Status</td>           <td>             <div>               <p> A code that indicates the status of the concept. Typical values are active, experimental,

                 deprecated, and retired</p> 
            </div>           </td>           <td> code</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">inactive            <a name="concept-properties-inactive"> </a>           </td>           <td> Inactive</td>           <td>             <div>               <p> True if the concept is not considered active - e.g. not a valid concept any more.

                 Property type is boolean, default value is false. Note that the status property
                 may also be used to indicate that a concept is inactive</p> 
            </div>           </td>           <td> boolean</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">effectiveDate            <a name="concept-properties-effectiveDate"> </a>           </td>           <td> effectiveDate</td>           <td>             <div>               <p> The date at which the concept status was last changed</p>             </div>           </td>           <td> dateTime</td>           <td/>          </tr>         <tr style="background-color: #ffeeee">          <td style="white-space:nowrap">deprecated            <a name="concept-properties-deprecated"> </a>           </td>           <td> Deprecated</td>           <td>             <div>               <p> The date at which a concept was deprecated. Concepts that are deprecated but not

                 inactive can still be used, but their use is discouraged, and they should be expected
                 to be made inactive in a future release. Property type is dateTime. Note that the
                 status property may also be used to indicate that a concept is deprecated. This
                 property is itself deprecated due to potential confusion with status - use deprecationDate
                 instead</p> 
            </div>           </td>           <td> dateTime</td>           <td> deprecated</td>         </tr>         <tr>           <td style="white-space:nowrap">deprecationDate            <a name="concept-properties-deprecationDate"> </a>           </td>           <td> Deprecation Date</td>           <td>             <div>               <p> The date at which a concept was deprecated. Concepts that are deprecated but not

                 inactive can still be used, but their use is discouraged, and they should be expected
                 to be made inactive in a future release. Property type is dateTime. Note that the
                 status property may also be used to indicate that a concept is deprecated</p> 
            </div>           </td>           <td> dateTime</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">retirementDate            <a name="concept-properties-retirementDate"> </a>           </td>           <td> Retirement Date</td>           <td>             <div>               <p> The date at which a concept was retired</p>             </div>           </td>           <td> dateTime</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">notSelectable            <a name="concept-properties-notSelectable"> </a>           </td>           <td> Not Selectable</td>           <td>             <div>               <p> The concept is not intended to be chosen by the user - only intended to be used

                 as a selector for other concepts. Note, though, that the interpretation of this
                 is highly contextual; all concepts are selectable in some context. Property type
                 is boolean, default value is false</p> 
            </div>           </td>           <td> boolean</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">parent            <a name="concept-properties-parent"> </a>           </td>           <td> Parent</td>           <td>             <div>               <p> The concept identified in this property is a parent of the concept on which it

                 is a property. The property type will be 'code'. The meaning of 'parent' is defined
                 by the hierarchyMeaning attribute</p> 
            </div>           </td>           <td> code</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">child            <a name="concept-properties-child"> </a>           </td>           <td> Child</td>           <td>             <div>               <p> The concept identified in this property is a child of the concept on which it is

                 a property. The property type will be 'code'. The meaning of 'child' is defined
                 by the hierarchyMeaning attribute</p> 
            </div>           </td>           <td> code</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">partOf            <a name="concept-properties-partOf"> </a>           </td>           <td> Part Of</td>           <td>             <div>               <p> The concept identified in this property (by its code) contains this concept as

                 a component (i.e. a part-of relationship rather than a subsumption relationship
                 such as elbow is part-of arm</p> 
            </div>           </td>           <td> code</td>           <td/>          </tr>         <tr style="background-color: #ffeeee">          <td style="white-space:nowrap">synonym            <a name="concept-properties-synonym"> </a>           </td>           <td> Synonym</td>           <td>             <div>               <p> This property contains an alternative code that may be used to identify this concept

                 instead of the primary code. Synonyms should not be used due to the operational
                 complexity they introduce - see alternateCode</p> 
            </div>           </td>           <td> code</td>           <td> deprecated</td>         </tr>         <tr>           <td style="white-space:nowrap">alternateCode            <a name="concept-properties-alternateCode"> </a>           </td>           <td> Alternate Code</td>           <td>             <div>               <p> This property contains the code for another representation of this concept, with

                 the same real-world meaning, in this code system.</p> 
            </div>           </td>           <td> code</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">comment            <a name="concept-properties-comment"> </a>           </td>           <td> Comment</td>           <td>             <div>               <p> A string that provides additional detail pertinent to the use or understanding

                 of the concept</p> 
            </div>           </td>           <td> string</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">itemWeight            <a name="concept-properties-itemWeight"> </a>           </td>           <td> itemWeight</td>           <td>             <div>               <p> A numeric value that allows the comparison (less than, greater than) or other numerical

                 manipulation of a concept (e.g. Adding up components of a score). Scores are usually
                 a whole number, but occasionally decimals are encountered in scores. In questionnaires,
                 the item weight may be represented using the 
                <a href="https://build.fhir.org/ig/HL7/fhir-extensions/StructureDefinition-itemWeight.html">http://hl7.org/fhir/StructureDefinition/itemWeight</a>  extension              </p>             </div>           </td>           <td> decimal</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">order            <a name="concept-properties-order"> </a>           </td>           <td> Order</td>           <td>             <div>               <p> Order of the concept amongst sibling concepts as a decimal value</p>             </div>           </td>           <td> decimal</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">definition            <a name="concept-properties-definition"> </a>           </td>           <td> Definition</td>           <td>             <div>               <p> A numeric value that allows the comparison (less than, greater than) or other numerical

                 manipulation of a concept (e.g. Adding up components of a score). Scores are usually
                 a whole number, but occasionally decimals are encountered in scores. In questionnaires,
                 the item weight may be represented using the 
                <a href="https://build.fhir.org/ig/HL7/fhir-extensions/StructureDefinition-itemWeight.html">http://hl7.org/fhir/StructureDefinition/itemWeight</a>  extension              </p>             </div>           </td>           <td> string</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">lastVersionActive            <a name="concept-properties-lastVersionActive"> </a>           </td>           <td> LastVersionActive</td>           <td>             <div>               <p> If the code is not active (properties inActive or based on status), then this property

                 conveys in what code system version it was last an active code.</p> 
            </div>           </td>           <td> string</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">replacedByCode            <a name="concept-properties-replacedByCode"> </a>           </td>           <td> ReplacedByCode</td>           <td>             <div>               <p> This property identifies a concept in this code system that is considered to replace

                 the use of this concept.  This property is generally only used on deprecated, withdrawn
                 or inactive concepts.</p> 
            </div>           </td>           <td> code</td>           <td/>          </tr>         <tr>           <td style="white-space:nowrap">replacedByCoding            <a name="concept-properties-replacedByCoding"> </a>           </td>           <td> ReplacedByCoding</td>           <td>             <div>               <p> This property identifies a concept in another code system that is considered to

                 replace the use of this concept.  This property is generally only used on deprecated,
                 withdrawn or inactive concepts.</p> 
            </div>           </td>           <td> Coding</td>           <td/>          </tr>       </table>     </div>   </text>   <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">    <valueCode value="vocab"/>   </extension>   <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">    <valueCode value="normative"/>   </extension>   <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">    <valueInteger value="4"/>   </extension>   <extension url="http://hl7.org/fhir/StructureDefinition/codesystem-use-markdown">    <valueBoolean value="true"/>   </extension>   <url value="http://hl7.org/fhir/concept-properties"/>   <identifier>     <system value="urn:ietf:rfc:3986"/>     <value value="urn:oid:2.16.840.1.113883.4.642.4.1826"/>   </identifier>   <version value="6.0.0-ballot3"/>   <name value="ConceptProperties"/>   <title value="FHIR Defined Concept Properties"/>   <status value="draft"/>   <experimental value="false"/>   <publisher value="HL7 International / Terminology Infrastructure"/>   <contact>     <telecom>       <system value="url"/>       <value value="http://hl7.org/fhir"/>     </telecom>   </contact>   <contact>     <telecom>       <system value="url"/>       <value value="http://www.hl7.org/Special/committees/Vocab/index.cfm"/>     </telecom>   </contact>   <description value="A set of common concept properties for use on coded systems throughout the FHIR

   eco-system."/> 
  <jurisdiction>     <coding>       <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>       <code value="001"/>       <display value="World"/>     </coding>   </jurisdiction>   <caseSensitive value="true"/>   <valueSet value="http://hl7.org/fhir/ValueSet/concept-properties"/>   <content value="complete"/>   <property>     <code value="dataType"/>     <uri value="http://hl7.org/fhir/concept-properties#dataType"/>     <description value="data type of property value"/>     <type value="code"/>   </property>   <property>     <extension url="http://hl7.org/fhir/StructureDefinition/codesystem-property-valueset">      <valueCanonical value="http://hl7.org/fhir/ValueSet/concept-property-type"/>     </extension>     <code value="status"/>     <uri value="http://hl7.org/fhir/concept-properties#status"/>     <description value="A code that indicates the status of the concept. Typical values are active, experimental,

     deprecated, and retired"/> 
    <type value="code"/>   </property>   <concept>     <code value="status"/>     <display value="Status"/>     <definition value="A code that indicates the status of the concept. Typical values are active, experimental,

     deprecated, and retired"/> 
    <property>       <code value="dataType"/>       <valueCode value="code"/>     </property>   </concept>   <concept id="t1">    <code value="inactive"/>     <display value="Inactive"/>     <definition value="True if the concept is not considered active - e.g. not a valid concept any more.

     Property type is boolean, default value is false. Note that the status property
     may also be used to indicate that a concept is inactive"/> 
    <property>       <code value="dataType"/>       <valueCode value="boolean"/>     </property>   </concept>   <concept>     <code value="effectiveDate"/>     <display value="effectiveDate"/>     <definition value="The date at which the concept status was last changed"/>     <property>       <code value="dataType"/>       <valueCode value="dateTime"/>     </property>   </concept>   <concept>     <code value="deprecated"/>     <display value="Deprecated"/>     <definition value="The date at which a concept was deprecated. Concepts that are deprecated but not

     inactive can still be used, but their use is discouraged, and they should be expected
     to be made inactive in a future release. Property type is dateTime. Note that the
     status property may also be used to indicate that a concept is deprecated. This
     property is itself deprecated due to potential confusion with status - use deprecationDate
     instead"/> 
    <property>       <code value="status"/>       <valueCode value="deprecated"/>     </property>     <property>       <code value="dataType"/>       <valueCode value="dateTime"/>     </property>   </concept>   <concept>     <code value="deprecationDate"/>     <display value="Deprecation Date"/>     <definition value="The date at which a concept was deprecated. Concepts that are deprecated but not

     inactive can still be used, but their use is discouraged, and they should be expected
     to be made inactive in a future release. Property type is dateTime. Note that the
     status property may also be used to indicate that a concept is deprecated"/> 
    <property>       <code value="dataType"/>       <valueCode value="dateTime"/>     </property>   </concept>   <concept>     <code value="retirementDate"/>     <display value="Retirement Date"/>     <definition value="The date at which a concept was retired"/>     <property>       <code value="dataType"/>       <valueCode value="dateTime"/>     </property>   </concept>   <concept>     <code value="notSelectable"/>     <display value="Not Selectable"/>     <definition value="The concept is not intended to be chosen by the user - only intended to be used

     as a selector for other concepts. Note, though, that the interpretation of this
     is highly contextual; all concepts are selectable in some context. Property type
     is boolean, default value is false"/> 
    <property>       <code value="dataType"/>       <valueCode value="boolean"/>     </property>   </concept>   <concept>     <code value="parent"/>     <display value="Parent"/>     <definition value="The concept identified in this property is a parent of the concept on which it

     is a property. The property type will be 'code'. The meaning of 'parent' is defined
     by the hierarchyMeaning attribute"/> 
    <property>       <code value="dataType"/>       <valueCode value="code"/>     </property>   </concept>   <concept>     <code value="child"/>     <display value="Child"/>     <definition value="The concept identified in this property is a child of the concept on which it is

     a property. The property type will be 'code'. The meaning of 'child' is defined
     by the hierarchyMeaning attribute"/> 
    <property>       <code value="dataType"/>       <valueCode value="code"/>     </property>   </concept>   <concept>     <code value="partOf"/>     <display value="Part Of"/>     <definition value="The concept identified in this property (by its code) contains this concept as

     a component (i.e. a part-of relationship rather than a subsumption relationship
     such as elbow is part-of arm"/> 
    <property>       <code value="dataType"/>       <valueCode value="code"/>     </property>   </concept>   <concept>     <code value="synonym"/>     <display value="Synonym"/>     <definition value="This property contains an alternative code that may be used to identify this concept

     instead of the primary code. Synonyms should not be used due to the operational
     complexity they introduce - see alternateCode"/> 
    <property>       <code value="dataType"/>       <valueCode value="code"/>     </property>     <property>       <code value="status"/>       <valueCode value="deprecated"/>     </property>     <property>       <code value="deprecationDate"/>       <valueCode value="2025-03-14"/>     </property>   </concept>   <concept>     <code value="alternateCode"/>     <display value="Alternate Code"/>     <definition value="This property contains the code for another representation of this concept, with

     the same real-world meaning, in this code system."/> 
    <property>       <code value="dataType"/>       <valueCode value="code"/>     </property>   </concept>   <concept>     <code value="comment"/>     <display value="Comment"/>     <definition value="A string that provides additional detail pertinent to the use or understanding

     of the concept"/> 
    <property>       <code value="dataType"/>       <valueCode value="string"/>     </property>   </concept>   <concept>     <code value="itemWeight"/>     <display value="itemWeight"/>     <definition value="A numeric value that allows the comparison (less than, greater than) or other numerical

     manipulation of a concept (e.g. Adding up components of a score). Scores are usually
     a whole number, but occasionally decimals are encountered in scores. In questionnaires,
     the item weight may be represented using the [[[http://hl7.org/fhir/StructureDefinition/itemW
    eight]]] extension"/> 
    <property>       <code value="dataType"/>       <valueCode value="decimal"/>     </property>   </concept>   <concept>     <code value="order"/>     <display value="Order"/>     <definition value="Order of the concept amongst sibling concepts as a decimal value"/>     <property>       <code value="dataType"/>       <valueCode value="decimal"/>     </property>   </concept>   <concept>     <code value="definition"/>     <display value="Definition"/>     <definition value="A numeric value that allows the comparison (less than, greater than) or other numerical

     manipulation of a concept (e.g. Adding up components of a score). Scores are usually
     a whole number, but occasionally decimals are encountered in scores. In questionnaires,
     the item weight may be represented using the [[[http://hl7.org/fhir/StructureDefinition/itemW
    eight]]] extension"/> 
    <property>       <code value="dataType"/>       <valueCode value="string"/>     </property>   </concept>   <concept>     <code value="lastVersionActive"/>     <display value="LastVersionActive"/>     <definition value="If the code is not active (properties inActive or based on status), then this property

     conveys in what code system version it was last an active code."/> 
    <property>       <code value="dataType"/>       <valueCode value="string"/>     </property>   </concept>   <concept>     <code value="replacedByCode"/>     <display value="ReplacedByCode"/>     <definition value="This property identifies a concept in this code system that is considered to replace

     the use of this concept.  This property is generally only used on deprecated, withdrawn
     or inactive concepts."/> 
    <property>       <code value="dataType"/>       <valueCode value="code"/>     </property>   </concept>   <concept>     <code value="replacedByCoding"/>     <display value="ReplacedByCoding"/>     <definition value="This property identifies a concept in another code system that is considered to

     replace the use of this concept.  This property is generally only used on deprecated,
     withdrawn or inactive concepts."/> 
    <property>       <code value="dataType"/>       <valueCode value="Coding"/>     </property>   </concept> 


</

CodeSystem

>



Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.