> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrumpbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord Sticky Roles

> Keep Discord member roles after they leave and rejoin with Scrump sticky roles, configurable blocked roles, slash commands, and a dashboard toggle.

Scrump sticky roles is a Discord role persistence feature. When it is enabled, Scrump records a member's roles when they leave your server and restores the roles that still exist when that same member rejoins.

<Note>Sticky roles is disabled by default and requires **Manage Server** and **Manage Roles** permission. Scrump also needs its bot role above every role it should restore.</Note>

## Enable Discord sticky roles

Run the enable command from a server-management channel:

```text theme={null}
/sticky-roles enable
```

To turn the feature off later, run:

```text theme={null}
/sticky-roles disable
```

You can also open the **Sticky roles** page in the Scrump server dashboard and switch **Enable sticky roles** on or off. The dashboard saves the same server setting as the slash commands.

## Block roles from being restored

Some roles should never come back automatically, such as temporary event roles, verification roles, muted roles, or staff roles. Plus and Pro servers can add those roles to the sticky-role blocklist:

```text theme={null}
/sticky-roles block-role add role: @Temporary Event
/sticky-roles block-role remove role: @Temporary Event
/sticky-roles block-role list
```

The dashboard has a multi-select control for the same blocklist. Saving the dashboard form replaces the complete list, so remove a role from the selection when it should become sticky again.

## Sticky role plan limits

| Plan | Blocked roles                                                              |
| ---- | -------------------------------------------------------------------------- |
| Free | Sticky roles are available, but blocked-role configuration is not included |
| Plus | Up to 5 blocked roles                                                      |
| Pro  | Unlimited blocked roles                                                    |

If a server downgrades, existing blocked roles remain respected. Free servers cannot add new blocked roles until Plus or Pro is active.

## How role restoration works

Scrump saves role IDs, not role names, when a member leaves. On rejoin it checks each saved role and skips it when:

* The role was deleted or no longer belongs to the server.
* The role is managed by a Discord integration.
* The role is the server's `@everyone` role.
* The role is in the blocked-role list.
* Scrump cannot assign it because of Discord role hierarchy or **Manage Roles** permission.

Role restoration is idempotent. A reconnect or duplicate Discord event will not create duplicate roles, and a new leave event records the member's current roles again.

## Sticky roles troubleshooting

If a member's roles are not restored, check that:

1. **Sticky roles** is enabled with `/sticky-roles block-role list` or in the dashboard.
2. Scrump has **Manage Roles** permission.
3. Scrump's bot role is above the missing role in **Server Settings → Roles**.
4. The role is not managed, deleted, or listed as a blocked role.
5. The member rejoined the same Discord server with the same account.

Scrump does not restore roles while the feature is disabled, and it cannot restore a role that Discord no longer allows the bot to manage.

## Discord sticky roles FAQ

### Does sticky roles work for a member who leaves before I enable it?

No. Scrump starts recording roles after the feature is enabled. Members who leave before that point have no saved snapshot.

### Are role names or permissions copied?

No. Scrump stores role IDs and reapplies the existing Discord roles. Renaming a role does not break restoration, but deleting and recreating a role gives it a new ID and it will not match the saved role.

### Can I stop one role from coming back?

Yes. Plus and Pro server managers can use `/sticky-roles block-role add role:` or the dashboard blocklist. The blocked role is filtered at restore time.

### Is sticky roles the same as auto roles?

No. Auto roles assign a configured onboarding set to every new member. Sticky roles restore only roles that a returning member had before leaving.

## Related Discord automation guides

* [Set up Discord auto roles](/features/automation/auto-roles)
* [Build a Discord role menu](/features/role-menu)
* [Ping new members during onboarding](/features/automation/ping-on-join)