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
R2
Responsible
Owner:
FHIR
Infrastructure
Work
Group
|
Normative
|
Use
Context
:
|
Official
URL
:
http://hl7.org/fhir/ValueSet/name-use
|
|
|||
| active as of 2025-11-14 |
|
|||
|
|
|
|||
This value set is used in the following places:
The use of a human name.
Generated
Narrative:
ValueSet
name-use
This
value
set
includes
codes
from
the
following
code
systems:
Last updated: 2025-11-14T20:54:02.388Z
http://hl7.org/fhir/name-use
version
📦6.0.0-ballot3
This
expansion
generated
01
14
Nov
2019
2025
ValueSet
This
value
set
contains
7
concepts
Expansion
performed
internally
based
on
http://hl7.org/fhir/name-use
version
4.0.1
All
codes
from
system
http://hl7.org/fhir/name-use
codesystem
NameUse
v6.0.0-ballot3
(CodeSystem)
This value set contains 7 concepts
|
| System | Code | Display | Definition |
v2
map
for
NameUse
|
v3
map
for
NameUse
![]() |
|
|
http://hl7.org/fhir/name-use
|
usual | Usual | Known as/conventional/the one you normally use. |
~
D
![]() |
~
C
|
|
|
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
![]() |
|
|
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
![]() |
|
|
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
![]() |
|
|
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
![]() |
|
|
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
![]() |
|
|
http://hl7.org/fhir/name-use
|
|
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 |