> For the complete documentation index, see [llms.txt](https://docs.b2ihealthcare.com/snowray/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.b2ihealthcare.com/snowray/reference/resources/conceptmaps.md).

# Concept Maps

Concept Maps are collections of terminology mappings that link components from different Code Systems.&#x20;

Each Concept Map is defined by a Source Domain, which determines the mapping sources, and a Target Domain, which provides the potential mapping targets.

{% hint style="info" %}
Any available Code System or Value Set can be selected as either a Source or a Target Domain.
{% endhint %}

## Browsing

Mappings that belong to the Concept Map can be browsed by navigating to the ***Content*** tab.

This tab displays the latest published version of the Concept Map as a table of mappings.

The table header provides information about the Source and Target domains involved in the Concept Map, including their respective versions. In addition, it displays the total number of mappings and the number of unmapped concepts.

![Concep Map Content Page](/files/7wcXkMCXcA9r99oDR9ER)

The search bar at the top of the table allows users to find specific mappings using term-based search.&#x20;

In addition, the advanced filter can be used to further refine the results by clicking on the <img src="/files/-MgF_7lK96B0cNPVQTro" alt="" data-size="line"> icon. Filtering options include refinement based on *Mappable*, *Mapping relation*, *Mapping status*, and *Issues*.

<img src="/files/82TuJiyl3L1rmTiSAlTB" alt="Concept Map Advanced Filter" width="233">

Once the required options are selected, clicking <img src="/files/8fT5Jr3hPTvLSK1yRq81" alt="" data-size="line"> refines the list to show only the matching resources.

{% hint style="info" %}
For more precise results, use term search in combination with the available options.
{% endhint %}

{% hint style="info" %}
When options are applied, a counter next to the icon indicates the number of active filters.
{% endhint %}

## Editing

On the ***Content*** tab of a Concept Map, users with `Write` permission can update mappings by clicking the <img src="/files/-MgKVp2L5HDY9DtV5zWv" alt="" data-size="line"> button in the upper-right corner, which navigates to the latest editable version of the Concept Map.

## Preview card

Hovering over a source or target concept displays a preview card with key details, such as the concept identifier or, for SNOMED CT concepts, the Fully Specified Name (FSN) and Preferred Term (PT).&#x20;

<figure><img src="/files/5rAuH1JUMgcDKns7NmRH" alt="" width="375"><figcaption><p>Concept Map Preview Card</p></figcaption></figure>

The preview card also provides access to the quick link, described below.

### Quick Link

The quick link feature allows users to view referenced concepts without interrupting their authoring flow.&#x20;

{% hint style="info" %}
The <img src="/files/kDwWBfsqYtmDdWqi3iGX" alt="" data-size="line"> icon representing the *Open in new tab* option is available not only on the preview card but also in the terminology tree while in editing mode.
{% endhint %}

Clicking this icon opens the selected concept in a new browser tab, displaying it in the corresponding Code System’s ***Content*** tab.


---

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

```
GET https://docs.b2ihealthcare.com/snowray/reference/resources/conceptmaps.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.
