> 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/implementation-guides/drug-model-implementation-guide/technical-application/deployment-and-versioning.md).

# Deployment and Versioning

## Distribution and Access

SNOMED CT drug content is distributed using Release Format 2 (RF2), the standard format for both the International Edition and all SNOMED CT extensions.

More information

* [Content Representation](/implementation-guides/drug-model-implementation-guide/content-development/drug-extension-development-principles/content-representation.md)
* [SNOMED CT Release File Specification](https://docs.snomed.org/snomed-ct-specifications/snomed-ct-release-file-specification/)
* [SNOMED CT Extension Guide](https://docs.snomed.org/snomed-ct-practical-guides/snomed-ct-extension-guide/)

The same format is used for both international content and national drug extensions, ensuring that they can be combined into a single, coherent terminology dataset.

Drug extensions are typically distributed as RF2 packages that are explicitly aligned to a specific version of the SNOMED CT International Edition. This dependency must be respected when deploying and updating terminology content.

## Approach

Implementations of the SNOMED CT Drug Model require loading a combined dataset consisting of:

* the SNOMED CT International Edition, which provides the clinical backbone (MP, MPF, CD)
* the National Drug Extension, which provides real-world product and packaging concepts (RCD, CDP, RPCD)
* associated terminology derivatives, e.g. mappings to local drug dictionaries (this may be part of a reference set in the Drug Extension)

Drug extensions are not standalone. They depend on the International Edition and extend it by adding product identity and packaging information. As a result, implementations must treat the terminology as a layered model, where extension concepts build directly on international concepts.

To ensure correct resolution of dependencies, content should be loaded in the following order:

* International Edition
* National Drug Extension
* Derivatives

Key considerations include:

* maintaining clear module separation between international and extension content
* ensuring version alignment between the extension and its dependent International Edition
* validating that all referenced concepts (e.g. substances, dose forms) are present
* building indexes to support efficient querying across the drug hierarchy

## Version Management

SNOMED CT drug content evolves continuously due to:

* introduction of new medicinal products
* regulatory changes
* updates to substances, dose forms, and strengths
* refinement of the concept model

RF2 uses an append-only versioning mechanism, where each change to a component results in a new version identified by its effective time and active status. Previous versions are retained, enabling full historical traceability.

Implementations should support:

* regular ingestion of updated releases
* identification of new, modified, and inactivated concepts
* reclassification and reindexing after updates

Concepts may be inactivated due to product withdrawal, modeling changes, or replacement by more accurate representations. Systems must detect inactive concepts and, where available, use historical association reference sets to identify replacement concepts. This is particularly important for maintaining continuity in longitudinal data.

Historical traceability allows systems to:

* interpret past medication records correctly
* support audit and regulatory requirements
* perform time-based analytics

Reference sets are also versioned and must be updated alongside core terminology content. This is especially important for:

* language refsets, which determine preferred terms for display
* mapping refsets, which link SNOMED CT concepts to local drug dictionaries

<a href="https://docs.google.com/forms/d/e/1FAIpQLScTmbZIf0UEQwYDkY27EEWBkaiYkHSbR0_9DmFrMLXoQLyL7Q/viewform?usp=pp_url&#x26;entry.1767247133=SNOMED+Drug+Extension+Guide&#x26;entry.670899847=Deployment%20and%20Versioning" 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/implementation-guides/drug-model-implementation-guide/technical-application/deployment-and-versioning.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.
