> 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-synonym.md).

# Adding a Synonym

To create a new entry box in the Descriptions Section, click the ![](https://snowowl.atlassian.net/wiki/download/attachments/611026132/descr-icon-02.png?version=1\&modificationDate=1578402206718\&cacheVersion=1\&api=v2)*Add description* icon. A small asterisk `*` next to the editor's title indicates that you have unsaved changes. 

![Text Box for Adding New Description](/files/Dno9XsTHmRED3jLRUSxy)

Select description type in the text box on the left. By default, a synonym is selected, but it can be changed by deleting the value and searching for another one. Then, specify your new description term in the text box to the right.

Click the ![](https://snowowl.atlassian.net/wiki/download/thumbnails/611026370/worddav3a3f88b3c5aa2fd23db3b9c27f990d19.png?version=1\&modificationDate=1578324741657\&cacheVersion=1\&api=v2\&width=16\&height=16) *Save* button in the main toolbar to submit your changes to the repository. Before the changes are saved, a dialog box will appear in which you can enter a comment describing your change.

Once the changes are saved, the new description appears in the editor. The box around the description type indicates an unpublished change. This means that the change has been saved in the repository, but has not been formally published yet. Once a concept is versioned, only the text appears.

![Box Around New Description Type Indicating Unpublished Change](/files/P9SdDfMUwDkixfpecajZ)

{% hint style="info" %}
Error, warning, and informational messages are displayed at the top of the Concept Editor. You can click on one of the messages to jump to this point in the Concept Editor.
{% endhint %}


---

# 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-synonym.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.