# Editions

## Editions

A SNOMED CT edition is a complete set of SNOMED CT components and reference set members that belong to an identified focus module plus all of the modules on which the focus module depends. Every SNOMED CT edition includes the contents of zero or more extension modules and the contents of the International Edition. The International Edition itself includes the contents of the [| SNOMED CT core module|](http://snomed.info/id/900000000000207008) and the [| SNOMED CT model component module|](http://snomed.info/id/900000000000012004) .

An edition consists of a set of modules (usually maintained by different organizations) that can be used as a standalone terminology solution within a healthcare environment. For this reason, many extension producers choose to publish their extension as an edition (which includes the content on which the extension depends), rather than as a separate extension. As explained in [Packaging and File Naming](https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-extension-guide/5-key-steps/5.6-distribution/5.6.1-preparing-for-distribution/5.6.1.2-packaging-and-file-naming), however, use cases exist for both packaging options.

The figure below illustrates the composition and dependencies of a local edition that is composed of a local extension module and the two international modules.

<figure><img src="https://3979592733-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3RKZIWpWFT0ocCgNT16E%2Fuploads%2Fgit-blob-9cd206a51699557e750002636368c99d6513ab48%2F57815137.png?alt=media" alt=""><figcaption><p>The composition of an edition is based on its module dependencies</p></figcaption></figure>

The local edition consists of all components and reference set members that belong to the focus module and the two modules on which the focus module depends - [| SNOMED CT core module|](http://snomed.info/id/900000000000207008) and the [| SNOMED CT model component module|](http://snomed.info/id/900000000000012004) . As discussed previously, the version specific dependencies must be stated in the Module Dependency Reference Set.

## Versioned Edition

There are many use cases that require a date specific version of an edition, including specifying the [substrate](https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-extension-guide/4-logical-design/broken-reference) of a SNOMED CT query, and specifying the version of SNOMED CT used to code a specific data element in a health record. A versioned edition includes the contents of the specified version of the focus module, plus the contents of all versioned modules on which the versioned focus module depends (as specified in the [| Module dependency reference set|](http://snomed.info/id/900000000000534007) ). The version of an edition is based on the date on which the edition was released. Many extension providers release their extensions as a versioned edition, using regular and predictable release cycles. For example, the International Edition is released by SNOMED International monthly.

Versioned editions can be identified using the [SNOMED CT URI Standard](https://app.gitbook.com/o/h8Z6qGxuQrzM9vbx5bPT/s/kgrE9Yh9vMDqL5ThuXjH/) using the following format:

<http://snomed.info/sct/{sctid}/version/{timestamp}>

where {sctid} represents the id of edition's focus module, and {timestamp} represents the release date of the edition. For more information, please refer to [URIs for Editions and Versions](https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-extension-guide/4-logical-design/broken-reference).

The table below shows some examples of versioned editions of SNOMED CT, with their corresponding focus module, URI and set of included modules.

**Table: URIs for versioned editions of SNOMED CT**

| Edition                                                      | Focus module                                                                                 | URI                                                                                                        | Included modules                                         |
| ------------------------------------------------------------ | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| International Edition, 20170731                              | [\| SNOMED CT core module\|](http://snomed.info/id/900000000000207008)                       | [SNOMED CT core module](http://snomed.info/sct/900000000000207008/version/20170731)                        | Metadata + Core                                          |
| <p>International Edition, 20170731<br>(with ICD-10 maps)</p> | [\| SNOMED CT to ICD-10 rule-based mapping module\|](http://snomed.info/id/449080006)        | <http://snomed.info/sct/449080006/version/20170731>                                                        | Metadata + Core + ICD-10 maps                            |
| US Edition, 20170901                                         | [\| US National Library of Medicine maintained module\|](http://snomed.info/id/731000124108) | [SNOMED CT to ICD-10 rule-based mapping module](http://snomed.info/sct/731000124108/version/20170901)      | Metadata + Core + NLM maintained module                  |
| <p>US Edition, 20170901</p><p>(with ICD-10-CM maps)</p>      | [\| SNOMED CT to ICD-10-CM rule-based mapping module\|](http://snomed.info/id/5991000124107) | [US National Library of Medicine maintained module](http://snomed.info/sct/5991000124107/version/20170901) | Metadata + Core + NLM maintained module + ICD-10-CM maps |

Please note that a versioned edition is a logical composition of modules, and does not necessarily correspond to a single release package. For more information on release packages, please refer to [Release Packages](https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-extension-guide/4-logical-design/4.5-release-packages) and [Packaging and File Naming](https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-extension-guide/5-key-steps/5.6-distribution/5.6.1-preparing-for-distribution/5.6.1.2-packaging-and-file-naming).

## Focus Module

As discussed above, an edition is defined based on a single focus module. This focus module must be the most dependent module, in that the focus module is dependent on all the other modules in the edition. Note that the [| SNOMED CT model component module|](http://snomed.info/id/900000000000012004) is always the least dependent module in all SNOMED CT editions, as it has no dependencies to other modules.

If a situation arises in which an extension has two equally dependent modules, then a new focus module may need to be created, with dependencies defined to all other modules in the edition. In this case, the focus module may contain only the components used to define the module concept itself and its dependencies as defined in the module dependency reference set. The image below illustrates a situation in which two (equally dependent) sibling modules exist - national module A and national module B - which are both dependent on the [| SNOMED CT core module|](http://snomed.info/id/900000000000207008) and the [| SNOMED CT model component module|](http://snomed.info/id/900000000000012004) , and are not dependent on each other. To form a national edition, which contains both national module A and national module B, a new focus module must be created that is dependent on all other modules in the edition. The concept id of the new focus module is then used in the URI of the national edition that contains both national module A and national module B.

<figure><img src="https://3979592733-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3RKZIWpWFT0ocCgNT16E%2Fuploads%2Fgit-blob-fd0123c71c6815b47f34a3a88214e15d076641f1%2F59343366.png?alt=media" alt=""><figcaption><p>Creating a new focus module to represent a national edition</p></figcaption></figure>

<a href="https://docs.google.com/forms/d/e/1FAIpQLScTmbZIf0UEQwYDkY27EEWBkaiYkHSbR0_9DmFrMLXoQLyL7Q/viewform?usp=pp_url&#x26;entry.1767247133=Extension+Guide&#x26;entry.670899847=4.4%20Editions" 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/4-logical-design/4.4-editions.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.
