FHIR © HL7.org  |  FHIRsmith 0.18.1  |  Server Home  |  XIG Home  |  XIG Stats  | 

FHIR IG analytics

Packagehl7.terminology
Resource TypeCodeSystem
IdCodeSystem-concept-properties.json
FHIR VersionR5
Sourcehttps://build.fhir.org/ig/HL7/UTG/CodeSystem-concept-properties.html
URLhttp://hl7.org/fhir/concept-properties
Version6.0.1
Statusactive
Date2026-10-26T16:01:42+00:00
NameConceptProperties
TitleFHIR Defined Concept Properties
Realmuv
Authorityhl7
DescriptionA set of common concept properties for use on coded systems throughout the FHIR eco-system.
Contentcomplete

Resources that use this resource

ValueSet
hl7.terminology#currentconcept-propertiesFHIR Defined Concept Properties
hl7.fhir.uv.termchangeset#currentcommon-cs-property-vsCommon CodeSystem Property ValueSet
hl7.fhir.uv.termchangeset#currentloinc-property-vsLOINC Property ValueSet
hl7.fhir.uv.termchangeset#currentsnomed-property-vsSNOMED CT Property ValueSet

Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: CodeSystem concept-properties

Last updated: 2026-10-05 18:39:10+0000

Properties

This code system defines the following properties for its concepts

NameCodeURITypeDescriptionValue Set
dataTypedataTypehttp://hl7.org/fhir/concept-properties#dataTypecodedata type of property value
Statusstatushttp://hl7.org/fhir/concept-properties#statuscodeA code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retiredProperty Type

Concepts

This case-sensitive code system http://hl7.org/fhir/concept-properties defines the following codes:

CodeDisplayDefinitiondataTypeStatus
status Status

A code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retired

code
inactive 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. Note that the status property may also be used to indicate that a concept is inactive

boolean
effectiveDate effectiveDate

The date at which the concept status was last changed

dateTime
deprecated 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. 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

dateTimedeprecated
deprecationDate Deprecation Date

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

dateTime
retirementDate Retirement Date

The date at which a concept was retired

dateTime
notSelectable Not Selectable

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

boolean
parent 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

code
child 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

code
partOf Part Of

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

code
synonym Synonym

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

codedeprecated
alternateCode Alternate Code

This property contains the code for another representation of this concept, with the same real-world meaning, in this code system.

code
comment Comment

A string that provides additional detail pertinent to the use or understanding of the concept

string
itemWeight itemWeight

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/itemWeight extension

decimal
order Order

Order of the concept amongst sibling concepts as a decimal value

decimal
definition Definition

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/itemWeight extension

string
lastVersionActive LastVersionActive

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.

string
lastVersionPresent LastVersionPresent

The value of the property is the version of the code system where the concept was last known to be present. This property is used in value set expansions to indicate concepts that are explicitly referenced in value set definitions but are no longer present in the code system version being used for the expansion. See the includeLastVersionPresent parameter in the Canonical Resource Management Infrastructure specialization of the ValueSet/$expand operation for a description of when this parameter is used. This property will only appear in expansions because it describes concepts that are not in the code system version used in the $expand.

string
replacedByCode ReplacedByCode

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.

code
replacedByCoding ReplacedByCoding

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.

Coding

Source1

{
  "resourceType": "CodeSystem",
  "id": "concept-properties",
  "meta": {
    "lastUpdated": "2026-10-05T18:39:10.170+00:00"
  },
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "vocab"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "normative"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 4
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/codesystem-use-markdown",
      "valueBoolean": true
    }
  ],
  "url": "http://hl7.org/fhir/concept-properties",
  "identifier": [
    {
      "system": "urn:ietf:rfc:3986",
      "value": "urn:oid:2.16.840.1.113883.4.642.4.1826"
    }
  ],
  "version": "6.0.1",
  "name": "ConceptProperties",
  "title": "FHIR Defined Concept Properties",
  "status": "active",
  "experimental": false,
  "date": "2026-10-26T16:01:42+00:00",
  "publisher": "HL7 International / Terminology Infrastructure",
  "contact": [
    {
      "telecom": [
        {
          "system": "url",
          "value": "http://hl7.org/fhir"
        }
      ]
    },
    {
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/Vocab/index.cfm"
        }
      ]
    }
  ],
  "description": "A set of common concept properties for use on coded systems throughout the FHIR eco-system.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001",
          "display": "World"
        }
      ]
    }
  ],
  "caseSensitive": true,
  "valueSet": "http://hl7.org/fhir/ValueSet/concept-properties",
  "content": "complete",
  "property": [
    {
      "code": "dataType",
      "uri": "http://hl7.org/fhir/concept-properties#dataType",
      "description": "data type of property value",
      "type": "code"
    },
    {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/codesystem-property-valueset",
          "valueCanonical": "http://hl7.org/fhir/ValueSet/concept-property-type"
        }
      ],
      "code": "status",
      "uri": "http://hl7.org/fhir/concept-properties#status",
      "description": "A code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retired",
      "type": "code"
    }
  ],
  "concept": [
    {
      "code": "status",
      "display": "Status",
      "definition": "A code that indicates the status of the concept. Typical values are active, experimental, deprecated, and retired",
      "property": [
        {
          "code": "dataType",
          "valueCode": "code"
        }
      ]
    },
    {
      "id": "t1",
      "code": "inactive",
      "display": "Inactive",
      "definition": "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": "dataType",
          "valueCode": "boolean"
        }
      ]
    },
    {
      "code": "effectiveDate",
      "display": "effectiveDate",
      "definition": "The date at which the concept status was last changed",
      "property": [
        {
          "code": "dataType",
          "valueCode": "dateTime"
        }
      ]
    },
    {
      "code": "deprecated",
      "display": "Deprecated",
      "definition": "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": "status",
          "valueCode": "deprecated"
        },
        {
          "code": "dataType",
          "valueCode": "dateTime"
        }
      ]
    },
    {
      "code": "deprecationDate",
      "display": "Deprecation Date",
      "definition": "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": "dataType",
          "valueCode": "dateTime"
        }
      ]
    },
    {
      "code": "retirementDate",
      "display": "Retirement Date",
      "definition": "The date at which a concept was retired",
      "property": [
        {
          "code": "dataType",
          "valueCode": "dateTime"
        }
      ]
    },
    {
      "code": "notSelectable",
      "display": "Not Selectable",
      "definition": "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": "dataType",
          "valueCode": "boolean"
        }
      ]
    },
    {
      "code": "parent",
      "display": "Parent",
      "definition": "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": "dataType",
          "valueCode": "code"
        }
      ]
    },
    {
      "code": "child",
      "display": "Child",
      "definition": "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": "dataType",
          "valueCode": "code"
        }
      ]
    },
    {
      "code": "partOf",
      "display": "Part Of",
      "definition": "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": "dataType",
          "valueCode": "code"
        }
      ]
    },
    {
      "code": "synonym",
      "display": "Synonym",
      "definition": "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": "dataType",
          "valueCode": "code"
        },
        {
          "code": "status",
          "valueCode": "deprecated"
        },
        {
          "code": "deprecationDate",
          "valueCode": "2025-03-14"
        }
      ]
    },
    {
      "code": "alternateCode",
      "display": "Alternate Code",
      "definition": "This property contains the code for another representation of this concept, with the same real-world meaning, in this code system.",
      "property": [
        {
          "code": "dataType",
          "valueCode": "code"
        }
      ]
    },
    {
      "code": "comment",
      "display": "Comment",
      "definition": "A string that provides additional detail pertinent to the use or understanding of the concept",
      "property": [
        {
          "code": "dataType",
          "valueCode": "string"
        }
      ]
    },
    {
      "code": "itemWeight",
      "display": "itemWeight",
      "definition": "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/itemWeight]]] extension",
      "property": [
        {
          "code": "dataType",
          "valueCode": "decimal"
        }
      ]
    },
    {
      "code": "order",
      "display": "Order",
      "definition": "Order of the concept amongst sibling concepts as a decimal value",
      "property": [
        {
          "code": "dataType",
          "valueCode": "decimal"
        }
      ]
    },
    {
      "code": "definition",
      "display": "Definition",
      "definition": "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/itemWeight]]] extension",
      "property": [
        {
          "code": "dataType",
          "valueCode": "string"
        }
      ]
    },
    {
      "code": "lastVersionActive",
      "display": "LastVersionActive",
      "definition": "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": "dataType",
          "valueCode": "string"
        }
      ]
    },
    {
      "code": "lastVersionPresent",
      "display": "LastVersionPresent",
      "definition": "The value of the property is the version of the code system where the concept was last known to be present. This property is used in value set expansions to indicate concepts that are explicitly referenced in value set definitions but are no longer present in the code system version being used for the expansion. See the includeLastVersionPresent parameter in the Canonical Resource Management Infrastructure specialization of the ValueSet/$expand operation for a description of when this parameter is used. This property will only appear in expansions because it describes concepts that are not in the code system version used in the $expand.",
      "property": [
        {
          "code": "dataType",
          "valueCode": "string"
        }
      ]
    },
    {
      "code": "replacedByCode",
      "display": "ReplacedByCode",
      "definition": "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": "dataType",
          "valueCode": "code"
        }
      ]
    },
    {
      "code": "replacedByCoding",
      "display": "ReplacedByCoding",
      "definition": "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": "dataType",
          "valueCode": "Coding"
        }
      ]
    }
  ]
}