Whenever a new description is added in an extension, the language preferences associated with that description must be specified. This is done by adding rows to a language reference set to indicate whether each description is  or  in the given language or dialect.


As previously mentioned, all reference sets use six  common attributes. In addition to these, a  also includes an acceptabilityId. The table below explains how each of these attributes is populated in a .

Summary of language reference set attributes

AttributeData TypeUse in a Language Reference Set

Can be generated using a standard generator.

effectiveTimeTimeSpecifies the date on which this version of the reference set member was released.

Indicates whether or not the reference set member is active at the given effectiveTime. This value is set to "1" for new reference set members.

moduleIdSCTIDIdentifies the module to which this reference set member belongs. For members in an extension, this will always be a module created by the extension producer.

This refers to the concept id of a descendant of and represents the language or dialect for which the preferences are defined. The reference set concept may be created in the extension, or may belong to a module on which the extension depends (e.g. the international core module).


The referencedComponentId refers to the id of the description whose acceptability is being defined.


The acceptabilityId indicates whether the description referenced by the referencedComponentId is or for the given language or dialect.

Note some extension producers may need to create and populate more than one language reference set. For example, where different languages or dialects are used within a country, or where both clinician and patient friendly terms must be specified.


In   below, two rows from the  are shown. Note that these rows specify French Canadian language preferences for the concept .

Rows from the |Canada French language reference set|

Please note the following: