# Rank Promotions

{% embed url="<https://app.guidde.com/share/playbooks/wJ25VP5VoPdCjmsS44zKHr?origin=G25dDmjNZ2b8ccFUz9X7G7W8T1k1>" %}

## What are Promotions?

**Promotion flows** let you easily promote or demote members within your community.

For example, a user with the **Rookie** rank can be promoted to **Member**, or an **Administrator** can be demoted to **Moderator**.

<figure><img src="https://3006847189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdBOa9OFjtdqw9FdXli%2Fuploads%2Fzj9jFOC0VCn7NchegS8S%2FScreenshot%20(477).png?alt=media&#x26;token=60321c20-9d79-45fd-a00f-5df74c513480" alt=""><figcaption></figcaption></figure>

## Creating Promotion Flows

<details>

<summary>Flow Information and Ranks</summary>

1. **Access the Promotions Panel**

Open the **Ranks** panel and select the **Promotions** tab at the top left.

In the **Promotions** panel, select **Promotion Flows** to view, add, edit, or remove existing promotion flows.

2. **Configure Promotion Ranks**

Use the **Promote From** and **Promote To** fields to label the flow.\
Exampl&#x65;**:** Promote from **Moderator** to **Admin**.

**Configure Rank Changes**

* In the **Ranks to Add** section, select **Admin**.
* In the **Ranks to Remove** section, select **Moderator**.

When executed, this flow will **add the Admin rank** and **remove the Moderator rank**, effectively promoting the user.

<figure><img src="https://3006847189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdBOa9OFjtdqw9FdXli%2Fuploads%2Fgit-blob-e1826d52f5547c381d7b963967f146eeeace717f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Promotion Flow Direction</summary>

**Configure Flow Direction**

By default, promotional flows can be executed in either direction—promotion or demotion. To reduce the risk of misuse, flows can be restricted to a single direction.

Select the toggle at the top to change between

* **Promotion and Demotion**
* **Promote Only**
* **Demote Only**

For example, a “mass demote” flow may be designed to remove all CMS ranks. If that same flow is accidentally run in reverse, it would instead grant every CMS rank to the user, leading to unintended privilege escalation.

<figure><img src="https://3006847189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdBOa9OFjtdqw9FdXli%2Fuploads%2FZa6p6Tgg0NEnSxOaP67S%2Fimage.png?alt=media&#x26;token=626191f3-fc7b-45ee-bb66-290754d9f505" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Flow Actions</summary>

When a promotion flow is ran, you can also run automated actions like a Discord webhook, push notification, and more.

<figure><img src="https://3006847189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdBOa9OFjtdqw9FdXli%2Fuploads%2FheiX3penhehWxCnm5mw9%2FScreenshot%202026-02-13%20at%2011.08.50%E2%80%AFAM.png?alt=media&#x26;token=56576c16-c912-47ed-a926-ce1d590c8dae" alt="" width="375"><figcaption></figcaption></figure>

</details>

### Multi-Flow Actions

<details>

<summary>Multi-Flow Actions</summary>

Communities can also define general actions that trigger when any one or more promotional flows are executed. This allows, for example, a single community announcement that summarizes all users included and all promotions applied.

<figure><img src="https://3006847189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdBOa9OFjtdqw9FdXli%2Fuploads%2F5EA1jG6CdaZAB3LsF9Ih%2FScreenshot%202026-02-13%20at%2011.11.01%E2%80%AFAM.png?alt=media&#x26;token=9c071593-48f0-411f-8855-bc88109a86f9" alt="" width="375"><figcaption></figcaption></figure>

</details>

## Running Promotion Flows

<details>

<summary>Via CMS</summary>

In the **Run Promotions** panel, select the **user(s)**, choose the **promotion flow**, and specify whether to **promote** or **demote**.

Use the **green “+” icon** to add additional rows, allowing you to run multiple promotional flows simultaneously.

<figure><img src="https://3006847189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdBOa9OFjtdqw9FdXli%2Fuploads%2Fgit-blob-e9b2ccc462a6fb07f4485fb5e2da90c724765981%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Via Discord Command</summary>

Communities can [run promotional flows right from a Discord command](https://docs.sonoransoftware.com/bot/tutorials/sonoran-cms-integration/promotion-flows)!

</details>

### Permissions

To allow others to manage Promotion Flows on your behalf, you can assign the following [permissions](https://docs.sonoransoftware.com/cms/tutorials/creating-departments#assigning-rank-permissions).

* Create/Edit/Remove Promotion Flows
  * **Modify Departments**
* Trigger Promotion Flows
  * **Change Permissions**
* Trigger promotion flows that include ranks above the triggering user’s permission level.
  * **Change Higher Permission**