Rank Promotions

Configure rank promotion flows for your community members.

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.

Creating Promotion Flows

Flow Information and Ranks

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.

1. Configure Promotion Ranks

Use the Promote From and Promote To fields to label the flow. Example: 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.

Promotion Flow Direction

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.

Flow Actions

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

Multi-Flow Actions

Multi-Flow Actions

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.

Running Promotion Flows

Via CMS

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.

Via Discord Command

Communities can run promotional flows right from a Discord command!

Via Form Stage Action

Communities can also create custom forms that will run promotional flows on selected users when the stage is changed.

The form can have an optional Promotional Flow and Member Selector question for the stage action to use. These form inputs can be used in the custom stage action.

Permissions

To allow others to manage Promotion Flows on your behalf, you can assign the following 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