Artifact Version Policy Codes

{
  "description" : "The versioning policy of an artifact (metadata, strict, loose, package)",
  "date" : "2026-02-18",
  "publisher" : "HL7 International",
  "content" : "complete",
  "property" : null,
  "name" : "ArtifactVersionPolicyCodes",
  "copyright" : "This material derives from the HL7 Terminology (THO). THO is copyright ©1989+ Health Level Seven International and is made available under the CC0 designation. For more licensing information see: https://terminology.hl7.org/license.html",
  "experimental" : false,
  "resourceType" : "CodeSystem",
  "title" : "Artifact Version Policy Codes",
  "extension" : [ {
    "valueCode" : "cds",
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg"
  }, {
    "valueCode" : "trial-use",
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status"
  }, {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 3
  }, {
    "extension" : [ {
      "valueString" : "concept",
      "url" : "path"
    }, {
      "url" : "count",
      "valueInteger" : 4
    } ],
    "url" : "http://health-samurai.io/extensions/excised-data"
  }, {
    "url" : "http://health-samurai.io/extensions/source",
    "valueCode" : "db"
  } ],
  "status" : "active",
  "language" : "en",
  "id" : "artifact-version-policy-codes",
  "valueSet" : "http://terminology.hl7.org/ValueSet/artifact-version-policy",
  "url" : "http://terminology.hl7.org/CodeSystem/artifact-version-policy-codes",
  "caseSensitive" : true,
  "version" : "3.0.0",
  "contact" : [ {
    "telecom" : [ {
      "system" : "url",
      "value" : "http://hl7.org"
    }, {
      "system" : "email",
      "value" : "hq@HL7.org"
    } ]
  } ],
  "text" : {
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\" xml:lang=\"en\" lang=\"en\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem artifact-version-policy-codes</b></p><a name=\"artifact-version-policy-codes\"> </a><a name=\"hcartifact-version-policy-codes\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\">Language: en</p></div><p>This case-sensitive code system <code>http://terminology.hl7.org/CodeSystem/artifact-version-policy-codes</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></tr><tr><td style=\"white-space:nowrap\">metadata<a name=\"artifact-version-policy-codes-metadata\"> </a></td><td>Metadata</td><td><div><p>A versioning policy that allows non-substantive changes to the metadata elements of an artifact without requiring a change to the value of the version element. Metadata elements are defined as elements that characterize information about the artifact (e.g. description, publisher, useContext, jurisdiction, approvalDate, etc) as defined by the MetadataResource pattern (including elements inherited by the CanonicalResource pattern), except for identity elements (i.e. url, version, and name). Content that makes use of the metadata versioning policy SHOULD still update the date element when metadata content changes. Repositories that host content using metadata versioning SHOULD use cache control headers to ensure downstream systems are aware of the possibility of changes to the artifact.</p>\n</div></td></tr><tr><td style=\"white-space:nowrap\">strict<a name=\"artifact-version-policy-codes-strict\"> </a></td><td>Strict</td><td><div><p>A versioning policy that indicates that any change to the content of an artifact, including non-substantive and metadata changes, requires a change to the value of the version element, with the exception of the <code>id</code> and <code>meta</code> elements (consistent with FHIR signature requirements) as well as the <code>status</code> (to allow for active content to be marked retired), and <code>lastReviewDate</code> (to allow for last review date to be communicated) elements. Repositories that host content using strict versioning SHOULD use cache control headers to ensure downstream systems are aware of the possibility of changes to the artifact.</p>\n</div></td></tr><tr><td style=\"white-space:nowrap\">loose<a name=\"artifact-version-policy-codes-loose\"> </a></td><td>Loose</td><td><div><p>A versioning policy that indicates that only breaking changes require a change to the value of the version element of the artifact. Content that makes use of the loose versioning policy SHOULD update the date element when content changes. Repositories that host content using loose versioning SHOULD use cache control headers to ensure downstream systems are aware of the possibility of changes to the artifact.</p>\n</div></td></tr><tr><td style=\"white-space:nowrap\">package<a name=\"artifact-version-policy-codes-package\"> </a></td><td>Package</td><td><div><p>A versioning policy that indicates that version of the artifact is managed as the version of the package in which the artifact appears. This is a common versioning policy often used when artifacts are published as part of an implementation guide, and is important to consider as it indicates that there may be version changes <em>without</em> corresponding changes in the content of a particular artifact. For example, if an implementation guide includes questionnaires, new versions of that implementation guide may include new questionnaires, but not change existing ones, and in this case, with package-managed versions, the existing questionnaires that had no actual changes would still be published with a new version.</p>\n</div></td></tr></table></div>",
    "status" : "generated"
  }
}