> For the complete documentation index, see [llms.txt](https://docs.snomed.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-extension-guide/4-logical-design/4.3-extensions/4.3.2-reference-sets/4.3.2.4-essential-reference-sets/4.3.2.4.1-language-reference-set.md).

# Language Reference Set

## Language Reference Set

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](https://confluence.ihtsdotools.org/display/DOCRELFMT/5.2.2.1+Language+Reference+Set) to indicate whether each description is [| acceptable|](http://snomed.info/id/900000000000549004) or [| preferred|](http://snomed.info/id/900000000000548007) in the given language or dialect.

## Attributes

As previously mentioned, all reference sets use six common attributes. In addition to these, a [| Language type reference set|](http://snomed.info/id/900000000000506000) also includes an **acceptabilityId**. The table below explains how each of these attributes is populated in a [| Language type reference set|](http://snomed.info/id/900000000000506000) .

**Table: Summary of language reference set attributes**

<table><thead><tr><th valign="top">Attribute</th><th valign="top">Data Type</th><th valign="top">Use in a Language Reference Set</th></tr></thead><tbody><tr><td valign="top">id</td><td valign="top">UUID</td><td valign="top">Can be generated using a standard <a href="https://confluence.ihtsdotools.org/display/DOCGLOSS/UUID">UUID</a> generator.</td></tr><tr><td valign="top">effectiveTime</td><td valign="top">Time</td><td valign="top">Specifies the date on which this version of the reference set member was released.</td></tr><tr><td valign="top">active</td><td valign="top">Boolean</td><td valign="top">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.</td></tr><tr><td valign="top">moduleId</td><td valign="top">SCTID</td><td valign="top">Identifies 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.</td></tr><tr><td valign="top">refsetId</td><td valign="top">SCTID</td><td valign="top">This refers to the concept id of a descendant of [</td></tr><tr><td valign="top">referencedComponentId</td><td valign="top">SCTID</td><td valign="top">The referencedComponentId refers to the id of the description whose acceptability is being defined.</td></tr><tr><td valign="top">acceptabilityId</td><td valign="top">SCTID</td><td valign="top">The acceptabilityId indicates whether the description referenced by the referencedComponentId is [</td></tr></tbody></table>

## Example

In the image below, two rows from the [20581000087109 | Canada French language reference set|](http://snomed.info/id/20581000087109) are shown. Note that these rows specify French Canadian language preferences for the concept [| Herpes labialis|](http://snomed.info/id/1475003) .

<figure><img src="/files/eTR5nR90CN5zy3XboaXw" alt=""><figcaption><p>Rows from the |Canada French language reference set</p></figcaption></figure>

Please note the following:

* The id column shows a UUID that has been uniquely generated for each refset member.
* The moduleId indicates that these refset members belong to the [| Canada Health Infoway French module|](http://snomed.info/id/20611000087101) .
* The refsetId indicates that both members are part of the [| Canada French language reference set|](http://snomed.info/id/20581000087109) .
* The referencedComponentId indicates the description for which the acceptability is being specified.
* The acceptabilityId indicates that both of these descriptions are [| Preferred|](http://snomed.info/id/900000000000548007) in this language.

<a href="https://docs.google.com/forms/d/e/1FAIpQLScTmbZIf0UEQwYDkY27EEWBkaiYkHSbR0_9DmFrMLXoQLyL7Q/viewform?usp=pp_url&#x26;entry.1767247133=Extension+Guide&#x26;entry.670899847=4.3.2.4.1%20Language%20Reference%20Set" class="button primary">Provide Feedback</a>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-extension-guide/4-logical-design/4.3-extensions/4.3.2-reference-sets/4.3.2.4-essential-reference-sets/4.3.2.4.1-language-reference-set.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
