# Add Members to a Reference Set

## Purpose

Reference set members can be added within an extension for a variety of reasons, including:

* To add members to a subset in the extension that is used nationally or locally
* To adapt a reference set created by another organization, by adding new members that are required nationally or locally

## Principles

Specifying members of a reference set can be done in different ways. It will depend on the requirements for the reference set what approach is feasible and possible. Please refer to the [Practical Guide to Reference Sets](https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-reference-set-guide/) for detailed instructions on the [authoring](broken://spaces/qOI2v58ZsXOoklmwBOk4/pages/EJxOApPTaDA2ergNyErg) and [methods](broken://spaces/qOI2v58ZsXOoklmwBOk4/pages/OAODM8u67Src4SdlxCmK) for identifying the SNOMED CT components that will be referenced by the members of the reference set.

However, each reference set member will be represented in the reference set in accordance with the following principles and process.

Reference set members may be added to reference sets belonging to modules in

* The producers extension
* The International Edition
* Other extensions (which the producers extension modules are dependent on)

Reference set members created in the extension should be created within the module of the extension producer, so that it is possible to distinguish the reference set members created within the producers extension from reference set members created by other organisations (i.e. belonging to other modules).

### Referenced Components

Even though the individual reference set members belong to the module of the extension producer, the actual components that are referenced by the reference set member, may belong to modules in

* The International Edition
* The extension in which the reference set and its members are produced
* Other extensions (which the producers extension modules are dependent on)

## Process

The table below provides a summary of the process to follow when adding members to a reference set.

<table><thead><tr><th width="216.51171875" valign="top">File Type</th><th valign="top">Process</th></tr></thead><tbody><tr><td valign="top">Reference Set</td><td valign="top">A new refset row is created with a unique <em>id</em>. The data type for this id is UUID and the id can be generated using a UUID generator. Note that a namespace identifier will not be part of this id.</td></tr><tr><td valign="top"></td><td valign="top"><p></p><p>Versioning and module identification attributes are set accordingly:</p><ul><li><em>effectiveTime</em> is set to the date the extension will be published</li><li><em>active</em> is set to reflect the status of the reference set member, i.e. 1 for active</li><li><em>moduleId</em> is set to identify a module concept managed by the extension producer</li></ul></td></tr><tr><td valign="top"></td><td valign="top"><p></p><p>Attributes common for all reference set types are set accordingly:</p><ul><li><em>refsetId</em> is set to the identifier of the concept used to identify and name the reference set. Note, the value of <em>refsetId</em> will be the same for all members in the reference set</li><li><em>referencedComponentId</em> is set to the identifier of the SNOMED CT component or reference set, which is referenced by this specific reference set member</li></ul></td></tr><tr><td valign="top"></td><td valign="top">Attributes specific to the reference set type are set. For more information, please refer to the <a href="/spaces/qOI2v58ZsXOoklmwBOk4/pages/6Papop3XX1WiP2LwetxR">release file specification</a>.</td></tr></tbody></table>

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


---

# Agent Instructions: 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:

```
GET https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-extension-guide/5-key-steps/5.4-authoring/5.4.6-authoring-reference-set-members/5.4.6.1-add-members-to-a-reference-set.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
