# Add Concepts to your Extension

## Demonstration Video

{% embed url="<https://app.guidde.com/share/playbooks/ui3xZbaxB5wSUn6zELxeZf>" %}

## Step-by-step instructions

#### 1. Click "Artifacts"

First, navigate to the extension artifacts manager area in Simplex.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2FkNnGEySs74nukyx9UsrCeb_doc.png?alt=media&#x26;token=0b2b721c-d7ef-4795-b54f-44f46b4fb5c1" alt="Click &#x27;Artifacts&#x27;"><figcaption></figcaption></figure>

#### 2. Click "Simple extension concepts"

Here, you'll notice that some concepts have already been added. These include the metadata concepts required to represent the extension plus any derivatives you have added. To view the concepts, and the details for managing these, click "Simple extension concepts".

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2FwEXyyniD8rZhy5iSA1mcGa_doc.png?alt=media&#x26;token=f653e00e-1ad7-441b-bf91-f136b65872d2" alt="Click &#x27;Simple extension concepts&#x27;"><figcaption></figcaption></figure>

#### 3. View concepts

Now, you see the concepts currently included in your extension to the right of the screen. Notice how you see the concepts naming and identifying the derivatives you have created. You will also find your module concept.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2F8f86nXi44yeZebYA12eTeZ_doc.png?alt=media&#x26;token=ec51dd38-5659-4ed4-9bba-427948aa8a87" alt="View concepts"><figcaption></figcaption></figure>

#### 4. Click "Download"

To create a new concept for your extension, the first thing you need to do is to download the spreadsheet with the details about the concepts in your extension. Click the download button to the right of step 1 in the process description below the concepts.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2FdoK6rvBB6omqCArSuNWrmh_doc.png?alt=media&#x26;token=3ee8aea3-d85d-469f-932d-3ec57cfb2d42" alt="Click &#x27;Download&#x27;"><figcaption></figcaption></figure>

#### 5. Access browser

Before editing the spreadsheet you just downloaded, you need to make sure that you know the details of the parent concept of your new extension concept. Therefore, go to your extension browser. You can do this by following the link next to any of your extension concepts

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2Fdh3FzSdSpVY3Xt238yMf2o_doc.png?alt=media&#x26;token=7b6c2871-e0a8-4373-b57b-1a51ec0c4418" alt="Access browser"><figcaption></figcaption></figure>

#### 6. Search to find appropriate parent concept

In the browser, do a search for the concept that should be the parent of your extension concept. In this example, I want to create a concept representing a local procedure on the respiratory system. So, the parent I want is the concept procedure on respiratory system.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2FkdTfhck68makvyvTCkT85k_doc.png?alt=media&#x26;token=70670488-4060-48d4-bd4f-847e14875344" alt="Search to find appropriate parent concept"><figcaption></figcaption></figure>

#### 7. Click "Copy FSN and Concept ID"

Once you've identified the appropriate parent concept for your new extension concept, copy the conceptId and a term for the parent concept.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2Fosf57KnrhqnSoCea7quEXo_doc.png?alt=media&#x26;token=7bbf7ff7-3d16-4893-a30c-84275dc4ba38" alt="Click &#x27;Copy FSN and Concept ID&#x27;"><figcaption></figcaption></figure>

#### 8. Open spreadsheet

Now, open the spreadsheet with the extension concepts you downloaded earlier in your preferred spreadsheet editor. Bear in mind that you should be able to save the spreadsheet in Excel format after editing.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2FrzHyVTBEEZmDAAxwX4F82s_doc.png?alt=media&#x26;token=eb7cac87-37f7-4a53-a83a-4c0fe06f4723" alt="Open spreadsheet"><figcaption></figcaption></figure>

#### 9. View the structure of the spreadsheet

This is the spreadsheet in which you apply all the information required to create your extension concepts. The first row includes some instructions helping you to add the necessary information correctly. Notice how the first two columns include the concept identifier and the terms for the parent concepts.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2FgC6MT8zfDuqPtE1xVLrYmH_doc.png?alt=media&#x26;token=fd40b534-76bc-4dea-ae65-8d29700a3c81" alt="View the structure of the spreadsheet"><figcaption></figcaption></figure>

#### 10. Enter ConeptId and term for the parent concept

In the first column, enter the conceptId for the parent concept, and in the second column, add the term for the parent concept. Notice that each extension concept created in Simplex can only have one parent.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2Fpp2UtHTTi47vjyXawFquvA_doc.png?alt=media&#x26;token=8fa66647-6b9d-4592-ba29-3775f051593f" alt="Enter ConeptId and term for the parent concept"><figcaption></figcaption></figure>

#### 11. Omit column C and D

As you are creating a new concept for your extension, you should ignore columns C and D, which are used to hold the identifier for the concept and the active state. When uploading the spreadsheet into Simplex, it will generate an identifier for your concept and assign it the status of active.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2Ff3X79GRsvVStiRx7rhtfRf_doc.png?alt=media&#x26;token=312f1a26-aff1-4e46-ae0c-3264ca6fe4c7" alt="Omit column C and D"><figcaption></figcaption></figure>

#### 12. Navigate to column E and F

Having provided the details about the parent concept, navigate to column E and F to apply the terms for the new extension concept. Column E is for terms in English and the US-English dialect. Column F is for terms in your local language or dialect.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2FwfgEUZyRpTFasNHQxdND8N_doc.png?alt=media&#x26;token=896e0a18-42f1-4b1a-82f3-8516a6982235" alt="Navigate to column E and F"><figcaption></figcaption></figure>

#### 13. Enter the preferred term

In this example, I am only going to create terms in English. In the same row as the details for the parent concept, I enter the term that is going to be the preferred term

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2FuQNZEe4v26gNfAoYVvu51b_doc.png?alt=media&#x26;token=6f239085-3efa-4923-82fe-30425a474b1f" alt="Enter the preferred term"><figcaption></figcaption></figure>

#### 14. Add synonyms

In the subsequent rows, you can add the synonyms you want for your concept. Please note that you don't need to add any values in column A to D

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2Fn5UHTNDoZCMzsTKNQPfkLJ_doc.png?alt=media&#x26;token=0d6ce5b5-72fd-4a25-8774-893c73b22a3d" alt="Add synonyms"><figcaption></figcaption></figure>

#### 15. Save and download spreadsheet

Once you have created your concepts and the related terms, you should save and download the spreadsheet in Excel format.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2FvguhCWpssiomQ7aocz59Pp_doc.png?alt=media&#x26;token=cb5d1a2c-f317-4c40-9142-bff1e827d0b2" alt="Save and download spreadsheet"><figcaption></figcaption></figure>

#### 16. Switch to Simplex

Once you have edited the spreadsheet with the details of your extension concepts, navigate back to simplex.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2Fe1xbWBeC9PscsHhyLvvUKa_doc.png?alt=media&#x26;token=2b4db668-4116-4afb-ad2b-283dac2fb169" alt="Switch to Simplex"><figcaption></figcaption></figure>

#### 17. Upload spreadsheet

Click the 'choose file' button in step 3 of the process and once the file has been selected, you click the 'upload data' button.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2FtVRtYBGbd1U792vU2HWD9e_doc.png?alt=media&#x26;token=1b82e2de-d08f-4761-bd8c-a54586842b6b" alt="Upload spreadsheet"><figcaption></figcaption></figure>

#### 18. View new concept

Once the import has been performed, you can now see the concept in the list of extension concepts. In the case of multiple concepts, you may have to navigate to another page, to see them all.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2F1iLVMopYEP4aVTBsQpWH71_doc.png?alt=media&#x26;token=fe698864-dddd-4188-b01e-4c28387118d7" alt="View new concept"><figcaption></figcaption></figure>

#### 19. Click "Open in Browser"

You can click 'Open in Browser', to view the concept and its associated synonyms.

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2FfUpy3nNiuM74JAYEMy7Pyx_doc.png?alt=media&#x26;token=1af2f85d-db87-44a6-86cc-21c9a91e9ce2" alt="Click &#x27;Open in Browser&#x27;"><figcaption></figcaption></figure>

#### 20. Review concept

In the browser, you can now see the concept appearing in the hierarchy as expected, with the parent you stated in the spreadsheet. You can also see the terms you stated as synonyms. Note that the concept has inherited the defining properties from its parent. In this example, the concept has a procedure site of 'Structure of respiratory system'

<figure><img src="https://static.guidde.com/v0/qg%2FiKQu6ToHloOCD99Y6AVoQVimxPj1%2F4JwtTbgFa71As9o5VhGXDR%2Fj6sAEJWqMqVbAB8pLN6duh_doc.png?alt=media&#x26;token=395ccf29-76b6-495b-abdc-ec7904dea13c" alt="Review concept"><figcaption></figcaption></figure>

<a href="https://docs.google.com/forms/d/e/1FAIpQLScTmbZIf0UEQwYDkY27EEWBkaiYkHSbR0_9DmFrMLXoQLyL7Q/viewform?usp=pp_url&#x26;entry.1767247133=SNOMED+Guide&#x26;entry.670899847=Add%20Concepts%20to%20your%20Extension" 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-user-guides/simplex-user-guide/how-to..../manage-extension-concepts-in-simplex/add-concepts-to-your-extension.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.
