Release 4 FHIR CI-Build

This page is part of the Continuous Integration Build of FHIR Specification (v4.0.1: R4 - Mixed Normative and STU ) in it's permanent home (it will always (will be available incorrect/inconsistent at this URL). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see times).
See the Directory of published versions . Page versions: R5 R4B R4 R3

Codesystem-name-use.xml

Example CodeSystem/name-use (XML)

Maturity Level : N/A
Responsible Owner: FHIR Infrastructure Work Group Standards Status : Informative

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

Definition for Code System NameUse SystemNameUse

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


  
  
    
  
  
    
    
      
      
        

      
      
      
        
          
            
          
          
            
          
          
            
          
          
            
          
        
        
          
          usual
            
          
          
          
        
        
          
          official
            
          
          
          The formal name as registered in an official (government) registry, but which name might
             not be commonly used. May be called &quot;legal name&quot;.
        
        
          
          temp
            
          
          
          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.
        
        
          
          nickname
            
          
          
          A name that is used to address the person in an informal manner, but is not part of their
             formal or usual name.
        
        
          
          anonymous
            
          
          
          Anonymous assigned name, alias, or pseudonym (used to protect a person's identity for
             privacy reasons).
        
        
          
          old
            
          
          
          
        
        
          
            maiden
            
          
          
          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's name.
        
      
    
  
  
    
  
  
    
  
  
    
  
  
    
  
  
  
    
    
  
  
  
  
  
  
  
  
  
    
      
      
    
    
      
      
    
  
  
  
  
  
  
    
    
    
  
  
    
    
    The formal name as registered in an official (government) registry, but which name might
     not be commonly used. May be called &quot;legal name&quot;.
  
  
    
    
    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.
  
  
    
    
    A name that is used to address the person in an informal manner, but is not part of their
     formal or usual name.
  
  
    
    
    Anonymous assigned name, alias, or pseudonym (used to protect a person's identity for
     privacy reasons).
  
  
    
    
    
    
      
      
      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's name.
    
  

<CodeSystem xmlns="http://hl7.org/fhir">
  <id value="name-use"/> 
  <meta> 
    <lastUpdated value="2025-11-10T15:17:08.817+00:00"/> 
  </meta> 
  <text> 
    <status value="generated"/> 
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p class="res-header-id">
        <b> Generated Narrative: CodeSystem name-use</b> 
      </p> 
      <a name="name-use"> </a> 
      <a name="hcname-use"> </a> 
      <p> This case-sensitive code system 
        <code> http://hl7.org/fhir/name-use</code>  defines the following codes in an undefined hierarchy:
      </p> 
      <table class="codes">
        <tr> 
          <td> 
            <b> Lvl</b> 
          </td> 
          <td style="white-space:nowrap">
            <b> Code</b> 
          </td> 
          <td> 
            <b> Display</b> 
          </td> 
          <td> 
            <b> Definition</b> 
          </td> 
        </tr> 
        <tr> 
          <td> 1</td> 
          <td style="white-space:nowrap">usual
            <a name="name-use-usual"> </a> 
          </td> 
          <td> Usual</td> 
          <td> Known as/conventional/the one you normally use.</td> 
        </tr> 
        <tr> 
          <td> 1</td> 
          <td style="white-space:nowrap">official
            <a name="name-use-official"> </a> 
          </td> 
          <td> Official</td> 
          <td> The formal name as registered in an official (government) registry, but which name
             might not be commonly used. May be called &quot;legal name&quot;.</td> 
        </tr>         <tr>           <td> 1</td>           <td style="white-space:nowrap">temp            <a name="name-use-temp"> </a>           </td>           <td> Temp</td>           <td> 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.</td> 
        </tr>         <tr>           <td> 1</td>           <td style="white-space:nowrap">nickname            <a name="name-use-nickname"> </a>           </td>           <td> Nickname</td>           <td> A name that is used to address the person in an informal manner, but is not part

             of their formal or usual name.</td> 
        </tr>         <tr>           <td> 1</td>           <td style="white-space:nowrap">anonymous            <a name="name-use-anonymous"> </a>           </td>           <td> Anonymous</td>           <td> Anonymous assigned name, alias, or pseudonym (used to protect a person's identity

             for privacy reasons).</td> 
        </tr>         <tr>           <td> 1</td>           <td style="white-space:nowrap">old            <a name="name-use-old"> </a>           </td>           <td> Old</td>           <td> This name is no longer in use (or was never correct, but retained for records).</td>         </tr>         <tr>           <td> 2</td>           <td style="white-space:nowrap">  maiden            <a name="name-use-maiden"> </a>           </td>           <td> Name changed for Marriage</td>           <td> 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's name.</td> 
        </tr>       </table>     </div>   </text>   <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">    <valueCode value="fhir"/>   </extension>   <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">    <valueCode value="normative"/>   </extension>   <url value="http://hl7.org/fhir/name-use"/>   <identifier>     <system value="urn:ietf:rfc:3986"/>     <value value="urn:oid:2.16.840.1.113883.4.642.4.66"/>   </identifier>   <version value="6.0.0-ballot3"/>   <name value="NameUse"/>   <title value="NameUse"/>   <status value="active"/>   <experimental value="false"/>   <date value="2025-11-10T15:17:08+00:00"/>   <publisher value="HL7 International / FHIR Infrastructure"/>   <contact>     <telecom>       <system value="url"/>       <value value="http://hl7.org/fhir"/>     </telecom>     <telecom>       <system value="email"/>       <value value="fhir@lists.hl7.org"/>     </telecom>   </contact>   <contact>     <telecom>       <system value="url"/>       <value value="http://www.hl7.org/Special/committees/fiwg"/>     </telecom>   </contact>   <description value="The use of a human name."/>   <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/name-use"/>   <content value="complete"/>   <concept>     <code value="usual"/>     <display value="Usual"/>     <definition value="Known as/conventional/the one you normally use."/>   </concept>   <concept>     <code value="official"/>     <display value="Official"/>     <definition value="The formal name as registered in an official (government) registry, but which name

     might not be commonly used. May be called &quot;legal name&quot;."/> 
  </concept>   <concept>     <code value="temp"/>     <display value="Temp"/>     <definition value="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."/> 
  </concept>   <concept>     <code value="nickname"/>     <display value="Nickname"/>     <definition value="A name that is used to address the person in an informal manner, but is not part

     of their formal or usual name."/> 
  </concept>   <concept>     <code value="anonymous"/>     <display value="Anonymous"/>     <definition value="Anonymous assigned name, alias, or pseudonym (used to protect a person's identity

     for privacy reasons)."/> 
  </concept>   <concept>     <code value="old"/>     <display value="Old"/>     <definition value="This name is no longer in use (or was never correct, but retained for records)."/>     <concept>       <code value="maiden"/>       <display value="Name changed for Marriage"/>       <definition value="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's name."/> 
    </concept>   </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.