R4 Ballot #1 (Mixed Normative/Trial use) Current Build
This is the FHIR R4 Mixed Normative/Trial Use Ballot #1, and the version for the Cologne Connectathon in May 2018. The current version is R3 . See the ballot introduction for details about the ballot. For a full list of available versions, see the Directory of published versions and Timelines for an explanation of STU and other statuses. Value Set http://hl7.org/fhir/ValueSet/name-use

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

This is a value set defined by the FHIR project.


Defining URL: http://hl7.org/fhir/ValueSet/name-use
Version: 4.0.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.3.65 (for OID based terminology systems)
Source Resource XML / JSON

This value set is used in the following places:

  • CodeSystem: This value set is the designated 'entire code system' value set for NameUse
  • This value set has translations in the ConceptMap v2 map for NameUse This value set has translations ConceptMap: Translation source in the ConceptMap v2 map for NameUse
  • This value set has translations in the ConceptMap v3 map for NameUse This value set has translations ConceptMap: Translation source in the ConceptMap v3 map for NameUse
  • Resource: HumanName.use ( (code / Required )

This value set includes codes from the following code systems:


This expansion generated 03 Apr 15 Dec 2018

This value set contains 7 concepts

Expansion based on http://hl7.org/fhir/name-use version 3.3.0 4.0.0

All codes from system http://hl7.org/fhir/name-use
Lvl Code Display Definition
0 usual Usual Known as/conventional/the one you normally use use.
0 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".
0 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.
0 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.
0 anonymous Anonymous Anonymous assigned name, alias, or pseudonym (used to protect a person's identity for privacy reasons) reasons).
0 old Old This name is no longer in use (or was never correct, but retained for records) records).
1    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 defined as part of FHIR.

Explanation of the columns that may appear on this page:

Lvl A few code lists that FHIR defines are hierarchical - each code is assigned a level. For value sets, levels are mostly used to organize codes for user convenience, but may follow code system hierarchy - 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