This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions 
Responsible Owner: FHIR Infrastructure Work Group |
Normative | Use Context: Country: World |
Official URL: http://hl7.org/fhir/ValueSet/name-use
|
Version: 6.0.0-ballot3 | |||
| active as of 2025-11-14 | Computable Name: NameUse | |||
| Flags: Immutable | OID: 2.16.840.1.113883.4.642.3.65 | |||
This value set is used in the following places:
The use of a human name.
Generated Narrative: ValueSet name-use
Last updated: 2025-11-14T20:54:02.388Z
http://hl7.org/fhir/name-use version 📦6.0.0-ballot3
This expansion generated 14 Nov 2025
ValueSet
Expansion performed internally based on codesystem NameUse v6.0.0-ballot3 (CodeSystem)
This value set contains 7 concepts
| Level | System | Code | Display | Definition | v2 map for NameUse ![]() | v3 map for NameUse ![]() |
| 1 | http://hl7.org/fhir/name-use |
usual | Usual | Known as/conventional/the one you normally use. | ~D ![]() |
~C ![]() |
| 1 | http://hl7.org/fhir/name-use |
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". | ~L ![]() |
~OR ![]() |
| 1 | http://hl7.org/fhir/name-use |
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. | ~TEMP ![]() |
~T ![]() |
| 1 | http://hl7.org/fhir/name-use |
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. | ~N ![]() |
~P ![]() |
| 1 | http://hl7.org/fhir/name-use |
anonymous | Anonymous | Anonymous assigned name, alias, or pseudonym (used to protect a person's identity for privacy reasons). | ~S ![]() |
~ANON ![]() |
| 1 | http://hl7.org/fhir/name-use |
old | Old | This name is no longer in use (or was never correct, but retained for records). | >NOUSE (No Use Addresses are considered to be old records)>BAD (bad addresses are old records) |
~OLD ![]() |
| 2 | http://hl7.org/fhir/name-use |
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. | ~M ![]() |
~M ![]() |
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 |