This
page
is
part
of
the
Continuous
Integration
Build
of
FHIR
Specification
(v5.0.0:
R5
-
STU
).
This
is
the
current
published
version
in
it's
permanent
home
(it
will
always
(will
be
available
incorrect/inconsistent
at
this
URL).
For
a
full
list
of
available
versions,
see
times).
See
the
Directory
of
published
versions
.
Page
versions:
R5
R4B
R4
R3
R2
Responsible
Owner:
FHIR
Infrastructure
Work
Group
|
Normative
|
Use Context : Country: World |
Official
URL
:
http://hl7.org/fhir/ValueSet/name-use
|
Version
:
|
|||
|
active
as
of
|
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
26
Mar
2023
14
Nov
2025
ValueSet
Expansion
performed
internally
based
on
codesystem
NameUse
v5.0.0
v6.0.0-ballot3
(CodeSystem)
This value set contains 7 concepts
| Level |
|
|
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 |