{
  "resourceType": "CodeSystem",
  "id": "name-use",
  "meta": {
    "lastUpdated": "2026-05-25T22:13:44.118+00:00"
  },
  "text": {
    "status": "generated",
    "div": "\u003cdiv xmlns\u003d\"http://www.w3.org/1999/xhtml\"\u003e\u003cp class\u003d\"res-header-id\"\u003e\u003cb\u003eGenerated Narrative: CodeSystem name-use\u003c/b\u003e\u003c/p\u003e\u003ca name\u003d\"name-use\"\u003e \u003c/a\u003e\u003ca name\u003d\"hcname-use\"\u003e \u003c/a\u003e\u003cp\u003eThis case-sensitive code system \u003ccode\u003ehttp://hl7.org/fhir/name-use\u003c/code\u003e defines the following codes in an undefined hierarchy:\u003c/p\u003e\u003ctable class\u003d\"codes\"\u003e\u003ctr\u003e\u003ctd\u003e\u003cb\u003eLvl\u003c/b\u003e\u003c/td\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003e\u003cb\u003eCode\u003c/b\u003e\u003c/td\u003e\u003ctd\u003e\u003cb\u003eDisplay\u003c/b\u003e\u003c/td\u003e\u003ctd\u003e\u003cb\u003eDefinition\u003c/b\u003e\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003e1\u003c/td\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003eusual\u003ca name\u003d\"name-use-usual\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eUsual\u003c/td\u003e\u003ctd\u003eKnown as/conventional/the one you normally use.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003e1\u003c/td\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003eofficial\u003ca name\u003d\"name-use-official\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eOfficial\u003c/td\u003e\u003ctd\u003eThe formal name as registered in an official (government) registry, but which name might not be commonly used. May be called \u0026quot;legal name\u0026quot;.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003e1\u003c/td\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003etemp\u003ca name\u003d\"name-use-temp\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eTemp\u003c/td\u003e\u003ctd\u003eA temporary name. Name.period can provide more detailed information. This may also be used for temporary names assigned at birth or in emergency situations.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003e1\u003c/td\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003enickname\u003ca name\u003d\"name-use-nickname\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eNickname\u003c/td\u003e\u003ctd\u003eA name that is used to address the person in an informal manner, but is not part of their formal or usual name.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003e1\u003c/td\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003eanonymous\u003ca name\u003d\"name-use-anonymous\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eAnonymous\u003c/td\u003e\u003ctd\u003eAnonymous assigned name, alias, or pseudonym (used to protect a person\u0027s identity for privacy reasons).\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003e1\u003c/td\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003eold\u003ca name\u003d\"name-use-old\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eOld\u003c/td\u003e\u003ctd\u003eThis name is no longer in use (or was never correct, but retained for records).\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003e2\u003c/td\u003e\u003ctd style\u003d\"white-space:nowrap\"\u003e  maiden\u003ca name\u003d\"name-use-maiden\"\u003e \u003c/a\u003e\u003c/td\u003e\u003ctd\u003eName changed for Marriage\u003c/td\u003e\u003ctd\u003eA name used prior to changing name because of marriage. This name use is for use by applications that collect and store names that were used prior to a marriage. Marriage naming customs vary greatly around the world, and are constantly changing. This term is not gender specific. The use of this term does not imply any particular history for a person\u0027s name.\u003c/td\u003e\u003c/tr\u003e\u003c/table\u003e\u003c/div\u003e"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "fhir"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "normative"
    }
  ],
  "url": "http://hl7.org/fhir/name-use",
  "identifier": [
    {
      "system": "urn:ietf:rfc:3986",
      "value": "urn:oid:2.16.840.1.113883.4.642.4.66"
    }
  ],
  "version": "6.0.0-ballot4",
  "name": "NameUse",
  "title": "NameUse",
  "status": "active",
  "experimental": false,
  "date": "2026-05-25T22:13:44+00:00",
  "publisher": "HL7 International / FHIR Infrastructure",
  "contact": [
    {
      "telecom": [
        {
          "system": "url",
          "value": "http://hl7.org/fhir"
        },
        {
          "system": "email",
          "value": "fhir@lists.hl7.org"
        }
      ]
    },
    {
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/fiwg"
        }
      ]
    }
  ],
  "description": "The use of a human name.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001",
          "display": "World"
        }
      ]
    }
  ],
  "caseSensitive": true,
  "valueSet": "http://hl7.org/fhir/ValueSet/name-use",
  "content": "complete",
  "concept": [
    {
      "code": "usual",
      "display": "Usual",
      "definition": "Known as/conventional/the one you normally use."
    },
    {
      "code": "official",
      "display": "Official",
      "definition": "The formal name as registered in an official (government) registry, but which name might not be commonly used. May be called \"legal name\"."
    },
    {
      "code": "temp",
      "display": "Temp",
      "definition": "A temporary name. Name.period can provide more detailed information. This may also be used for temporary names assigned at birth or in emergency situations."
    },
    {
      "code": "nickname",
      "display": "Nickname",
      "definition": "A name that is used to address the person in an informal manner, but is not part of their formal or usual name."
    },
    {
      "code": "anonymous",
      "display": "Anonymous",
      "definition": "Anonymous assigned name, alias, or pseudonym (used to protect a person\u0027s identity for privacy reasons)."
    },
    {
      "code": "old",
      "display": "Old",
      "definition": "This name is no longer in use (or was never correct, but retained for records).",
      "concept": [
        {
          "code": "maiden",
          "display": "Name changed for Marriage",
          "definition": "A name used prior to changing name because of marriage. This name use is for use by applications that collect and store names that were used prior to a marriage. Marriage naming customs vary greatly around the world, and are constantly changing. This term is not gender specific. The use of this term does not imply any particular history for a person\u0027s name."
        }
      ]
    }
  ]
}