> For the complete documentation index, see [llms.txt](https://docs.b2ihealthcare.com/snow-owl-authoring-platform/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/snow-owl-authoring-platform/editing-and-authoring/snomed-ct-editing/concept-editing/adding-a-relationship.md).

# Adding a Relationship

You can add new relationships on the Overview Page or on the Source Relationships Page. When creating a new relationship an identifier is automatically generated, which conforms to SNOMED International rules and uses the namespace configured in the ![](https://snowowl.atlassian.net/wiki/download/attachments/611026132/sct-setting-icon.png?version=1\&modificationDate=1578401875208\&cacheVersion=1\&api=v2)*SNOMED CT Settings*. The source of the relationship is the concept that you are currently editing. Relationship type and target concepts can be selected by using the search dialog.&#x20;

### Adding a Relationship on the Overview Page <a href="#editingsnomedctcontent-addingarelationshipontheoverviewpage" id="editingsnomedctcontent-addingarelationshipontheoverviewpage"></a>

Relationship types that conform to the concept model are automatically displayed in the Properties section of the Overview Page.

To define a relationship:

* Click the ![](https://snowowl.atlassian.net/wiki/download/attachments/611026132/add-rela-icon-01.png?version=1\&modificationDate=1578402541177\&cacheVersion=1\&api=v2) *Add property* button in the Properties Section to create new entry fields. You might have to scroll down to see the two new fields.
* Enter the *relationship type* in the first entry field. When you start typing a list of valid values is displayed from which you can select the relationship type.

![List of Sanctioned Property Types Conforming to the MRCM](/files/nWWHXEIB0VBFXwyFN9tH)

* Enter the *relationship value* in the second entry field and select a concept from the list. The list shows concepts classified either as *Sanctioned* or as *Unsanctioned*. *Sanctioned* are the ones that are valid based on the MRCM rules. *Unsanctioned* ones are not valid based on the MRCM rules but are also selectable.

![List of Sanctioned Property Values Conforming to the MRCM](/files/DFgdsCU5b1JgFC3A1rNm)

* &#x20;<img src="https://snowowl.atlassian.net/wiki/download/thumbnails/611026370/worddav3a3f88b3c5aa2fd23db3b9c27f990d19.png?version=1&#x26;modificationDate=1578324741657&#x26;cacheVersion=1&#x26;api=v2&#x26;width=16&#x26;height=16" alt="" data-size="line"> *Save* your work.

The new relationship is now displayed on the Overview Page and also on the Source Relationship Page.&#x20;

{% hint style="info" %}
The values for Characteristic type, Group, Union group, Modifier, and Relationship negated are automatically set.
{% endhint %}

![SNOMED CT Relationship Tooltip](/files/LbqbbqzDcDdwbSDRduNv)

### Adding a Relationship on the Source relationship Page <a href="#editingsnomedctcontent-addingarelationshiponthesourcerelationshippage" id="editingsnomedctcontent-addingarelationshiponthesourcerelationshippage"></a>

The New SNOMED CT Relationship Wizard allows defining any kind of relationship and modifying its settings, therefore using the Source Relationships Page is advised for more advanced users with specific requirements. The values for Characteristic type, Group, Union group, Modifier, and Relationship negated can be manually modified.

To add a new relationship from the Source Relationship Page you need to reveal the New SNOMED CT Relationship Wizard.

* Click on the ![](https://snowowl.atlassian.net/wiki/download/attachments/611026132/add-rela-icon-01.png?version=1\&modificationDate=1578402541177\&cacheVersion=1\&api=v2) *Add relationship* button in the top right corner to open the wizard. You can see the new relationship ID that was created.

![New SNOMED CT Relationship Wizard](/files/MjzNNx6f3jFP1HteiRDy)

* *Relationship type***:** Start typing in the entry field to display a list of values classified either as *Sanctioned* or as *Unsanctioned*. *Sanctioned* are the ones that are valid based on the MRCM rules, while *Unsanctioned* are the ones that are invalid based on MRCM rules but are also selectable.
* *Destination*: Can only be specified after selecting the relationship type. Enter the relationship value here. A Quick Search list of values is displayed classified either as *Sanctioned* or as *Unsanctioned*. *Sanctioned* are the ones that are valid based on the MRCM rules, while *Unsanctioned* are the ones that are invalid based on MRCM rules, still selectable.
* If necessary, modify the other values in the dialog.
* Click **`Finish`** to close the dialog.
* <img src="https://snowowl.atlassian.net/wiki/download/thumbnails/611026370/worddav3a3f88b3c5aa2fd23db3b9c27f990d19.png?version=1&#x26;modificationDate=1578324741657&#x26;cacheVersion=1&#x26;api=v2&#x26;width=16&#x26;height=16" alt="" data-size="line"> *Save* your work.

The new relationship is now displayed in the table of the Source relationship Page and also on the Overview Page.


---

# 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.b2ihealthcare.com/snow-owl-authoring-platform/editing-and-authoring/snomed-ct-editing/concept-editing/adding-a-relationship.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.
