Roles Synchronization

You can set up synchronization of WordPress user roles with Discord member roles. To do this first you need to assign bindings of roles pairs. Go to the WordPress admin panel and to Settings --> Discord and in the Roles Synchronization section you will find the interface of bonding.

A left selector is the WordPress role and the right one is the Discord role. If you do not see all Discord roles in the selector try to update roles data in the Data Update Intervals section, also if the role is already bonded it will not appear in the selector. The arrow shows the direction of synchronization. If the arrow points from WordPress to Discord then during syncing Discord roles will be changed accordingly to WordPress. If it points from Discord to WordPress then WordPress roles will be changed accordingly to Discord. To switch the direction of the syncing click Reverse button beneath the arrow.

WordPress is keeping multiple assigned roles but displaying only the highest one.

For example, if you syncing 2 roles from WP to Discord and the user has only one WP role then the existing role will be assigned, and absent will be removed from Discord. During synchronization, not bonded roles from both sides will be ignored.

Be very careful with bonding pairs. As an administrator, you can assign any combinations, for example, you can bind administrator WordPress role with some common role on Discord, and all WP users will get or lose the administrator role depending on the sync direction. These actions are not reversible and you will have to restore website backup to undo it!

If you synchronizing roles from WP to Discord make sure that the roles you are trying to assign are positioned beneath the Bot role. To do this go to the Discord app and open guild settings. On the Roles page, you can find a list of existing roles, rearrange them - put bot role on top of all assignable roles.

Roles synchronization will work only with WordPress profiles with connected Discord profile.

You can start synchronization of all users right now by clicking Synchronize All Roles button. By default roles of all users are scheduled for synchronization every 4 days. Also, the particular user will be synchronized on registration and authorization on the website via Discord profile.