FHIR Release 3 (STU) Current Build
This page is part of FHIR STU 3 (v3.0.1) in it's permanent home (it will always be available at this URL). It has been superceded by R4 . For a full list of available versions, see the Directory of published versions . Code System http://hl7.org/fhir/name-use

Vocabulary FHIR Infrastructure Work Group   Maturity Level : 0 N Informative Normative (from v4.0.0) Use Context : Any

This is a code system defined by the FHIR project.


Defining URL: http://hl7.org/fhir/name-use
Version: 4.1.0
Name: NameUse
Title: NameUse

The use of a human name name.

Committee: FHIR Infrastructure Work Group
OID: 2.16.840.1.113883.4.642.1.59 2.16.840.1.113883.4.642.1.66 (for OID based terminology systems)
Source Resource XML / JSON

This Code system is used in the following value sets:

  • ValueSet: NameUse (The use of a human name) name.)
  • ValueSet: NameUse (The use of a human name.)

The use of a human name name.

This code system http://hl7.org/fhir/name-use defines the following codes:
Lvl Code Display Definition
1 usual Usual Known as/conventional/the one you normally use use.
1 official Official The formal name as registered in an official (government) registry, but which name might not be commonly used. May be called "legal name".
1 temp 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.
1 nickname Nickname A name that is used to address the person in an informal manner, but is not part of their formal or usual name name.
1 anonymous Anonymous Anonymous assigned name, alias, or pseudonym (used to protect a person's identity for privacy reasons) reasons).
1 old Old This name is no longer in use (or was never correct, but retained for records) records).
2   maiden Name changed for Marriage 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 name.


See the full registry of value sets code systems defined as part of FHIR.

Explanation of the columns that may appear on this page:

Level A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes are under other codes, and imply that the code they are under also applies See Code System for further information.
Source The source of the definition of the code (when the value set draws in codes defined elsewhere)
Code The code (used as the code in the resource instance). If the code is in italics, this indicates that the code is not selectable ('Abstract')
Display The display (used in the display element of a Coding ). If there is no display, implementers should not simply display the code, but map the concept into their application
Definition An explanation of the meaning of the concept
Comments Additional notes about how to use the code