US Core Implementation Guide
5.0.1 - STU5 Release US

This page is part of the US Core (v5.0.1: STU5) based on FHIR R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

ValueSet: Language codes with language and optionally a region modifier

Official URL: Version: 5.0.1
Active as of 2019-05-21 Computable Name: LanguageCodesWithLanguageAndOptionallyARegionModifier

Copyright/Legal: ISO Maintains the copyright on the country codes and controls it’s use carefully. For further details, see the ISO 3166 Home Page

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.


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

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