# Adding Ranks

{% embed url="<https://www.youtube.com/watch?v=eoI5ah6amf4>" %}

You can enable role syncing with TeamSpeak after setting up the connection by navigating to the `Role Sync` tab and checking the `Enable Role Sync` button.

<figure><img src="/files/inadNo9mKoXJEXCrK0Ce" alt=""><figcaption><p>Sonoran CMS- TS Role Sync Enabled</p></figcaption></figure>

## Adding a Rank

Steps for adding a rank that is associated with a group on your TeamSpeak server:

1. Click the **Add Mapping** button on the CMS admin panel

<div align="center"><figure><img src="/files/OUBKO9vU6rBKUUNRF7nx" alt=""><figcaption><p>Sonoran CMS - Add Mapping</p></figcaption></figure></div>

2. Select the CMS department and rank you'd like to use in the dropdown that just appeared

<div align="left"><figure><img src="/files/KlqEKaiz75Y91pgjAbQD" alt=""><figcaption><p>Sonoran CMS - Rank Selection</p></figcaption></figure></div>

3. Input the TeamSpeak group permanent ID into the **TeamSpeak Group ID** input

<figure><img src="/files/7rreT8wT1OFr38mPxrrZ" alt=""><figcaption><p>Sonoran CMS - Input Group ID</p></figcaption></figure>

* A TeamSpeak's group ID can be found by hovering over it in the permission editor
* Additionally, if you have Sonoran Radio installed you can also follow [this guide](https://info.sonoranradio.com/en/tutorials/permissions#server-group-ids)

<div align="left"><figure><img src="https://i.imgur.com/H608nba.png" alt=""><figcaption><p>TeamSpeak - Group IDs</p></figcaption></figure></div>

Repeat this for all ranks you'd like to map to a TeamSpeak Group.

This method will soon be deprecated and be replaced by the following:

3. (Coming soon) Select a TeamSpeak group from the dropdown to the right.

<figure><img src="/files/67z5xft0rw0hPtf6prF9" alt=""><figcaption><p>Sonoran CMS - Group Selection</p></figcaption></figure>

## Setting up Your Users

For users in your community to benefit from this feature, they must setup their TeamSpeak UID after you've setup your connection. Check out this guide for adding your UID to CMS:

{% content-ref url="/pages/YB7aN7ZMyd7ID9tlbfRJ" %}
[Adding your TeamSpeak UID](/cms/integration-capabilities/teamspeak-3-role-sync/adding-your-teamspeak-uid.md)
{% endcontent-ref %}


---

# 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.sonoransoftware.com/cms/integration-capabilities/teamspeak-3-role-sync/adding-ranks.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.