US Core Implementation Guide
4.1.0 - CI Build

US Core Implementation Guide, published by HL7 International - US Realm Steering Committee. This is not an authorized publication; it is the continuous build for version 4.1.0). This version is based on the current content of and changes regularly. See the Directory of published versions

ValueSet: Language codes with language and optionally a region modifier


Defining URL:
Title:Language codes with language and optionally a region modifier
Status:Active as of 2019-05-21

This value set includes codes from BCP-47. This value set matches the ONC 2015 Edition LanguageCommunication data element value set within C-CDA to use a 2 character language code if one exists, and a 3 character code if a 2 character code does not exist. It points back to RFC 5646, however only the language codes are required, all other elements are optional.

Publisher:HL7 International - US Realm Steering Committee

ISO Maintains the copyright on the country codes and controls it's use carefully. For further details, see the ISO 3166 Home Page

Source Resource:XML / JSON / Turtle


Logical Definition (CLD)

  • Include codes from urn:ietf:bcp:47 where ext-lang doesn't exist, script doesn't exist, variant doesn't exist, extension doesn't exist and private-use doesn't exist



No Expansion for this valueset (not supported by Publication Tooling)

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
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)
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


The publication tooling is unable to expand the language value set because they are based on a grammar. To aid in the reader’s understanding, sample codes are shown below:

ISO 639-2 Code ISO 639-1 Code English name of Language
eng en English
spa es Spanish
chi (B), zho (T) zh Chinese
fre (B), fra (T) fr French
tgl tl Tagalog
vie vi Vietnamese