> 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="https://3979592733-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3RKZIWpWFT0ocCgNT16E%2Fuploads%2Fgit-blob-3beeb298513fef1f42b52a0078cc23be7efc02e3%2F57815130.png?alt=media" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
