Fix Discord roles that aren't syncing
Read the Latest sync results, fix the bot's role and permissions, and sort out members who aren't getting or losing the Discord roles you linked.
If someone has been promoted but their Discord roles haven't changed, or a role won't come off when it should, the answer is nearly always on the Role links page. This article walks you through reading it, then covers each problem and how to fix it.
Before you start#
You need to be the owner, or have a role with the Connect Discord servers and link Discord roles permission.
Check the Latest sync results#
- Click Discord servers in the left sidebar.
- Next to the server, click Role links.
- Look at the Latest sync box near the top.
It shows when the last sync ran and how many people are in each result:
| Result | What it means |
|---|---|
| Synced | Their roles and nickname match LonexOne. |
| Not in server | They aren't a member of this Discord server, so there's nothing to give roles to. |
| Failed | Discord refused, or couldn't be reached. The Detail column says why. |
| No Discord account | Their LonexOne account has no Discord account linked. |
Underneath, a table lists up to 25 recent people who failed or had something skipped, with the reason in Detail.
Check the warnings at the top of the page#
The Role links page checks the bot for you and shows a warning if something's wrong:
- The bot isn't in this server, so no roles are synced here until it's added back. Go back to Discord servers and click Add the bot next to the server.
- The bot doesn't have the Manage Roles permission... In Discord, open Server Settings, then Roles, pick the LonexOne role and turn on Manage Roles.
- Nicknames are on for this server, but the bot doesn't have the Manage Nicknames permission. Turn on Manage Nicknames for the LonexOne role in the same place.
Next to Discord roles in this server you can also see the bot's highest role and its position, and whether it has Manage Roles and Manage Nicknames.
Make sure the bot's role is high enough#
A bot can only give or take roles below its own highest role. In the Discord roles in this server table, any role showing Above the bot's role can't be given.
- In Discord, open Server Settings, then Roles.
- Drag the LonexOne role above the roles you've linked.
- Back on the Role links page, click Refresh roles.
- Click Sync everyone now.
When it works, the roles show The bot can give this role.
Try a sync now#
Changes usually reach Discord within a minute. If you've fixed something and don't want to wait for the nightly check, click Sync everyone now at the top of the Role links page. Results fill in under Latest sync as they finish.
Something not working?#
Someone shows as "Not in server". They hadn't joined the Discord server when LonexOne last checked. When they join, LonexOne gives them their roles and nickname within a minute. If that doesn't happen, their roles arrive with the next nightly check, or straight away if you click Sync everyone now.
The Detail says "Skipped @Role: At or above the bot's highest role." The role is above the LonexOne role. Move the LonexOne role up in Discord, as above.
The Detail says "Skipped @Role: Managed by an integration." That role belongs to Discord or another bot, like a booster or subscriber role. No bot can give it out. Unlink it and use a normal role instead.
The Detail says "The bot is missing access or permissions." The bot doesn't have Manage Roles (or Manage Nicknames for nicknames), or the role is above it. Check both.
The Detail says "Could not reach Discord." Discord didn't answer. LonexOne tries again by itself a few times over the next few minutes. If it's still failing later, click Sync everyone now.
Someone shows as "No Discord account". Their LonexOne account isn't linked to a Discord account, so LonexOne can't find them in your server. They need to sign in to your community's website with Discord.
A role won't come off someone. LonexOne only takes a linked role off people it gave it to. If they had the role before you linked it, or someone gave it to them by hand in Discord, LonexOne leaves it alone. Remove it by hand once, and from then on LonexOne will manage it.
Someone got a role they shouldn't have. Check what the role is linked to on the Role links page. Remember that department links without a condition include people who are active, in training and on leave, and that the same Discord role can be linked to more than one thing.
Roles stopped changing for everyone. Check the warnings at the top of the Role links page first. Syncing also stops while a community is suspended. See When an invoice isn't paid.
A server's roles look out of date in LonexOne. LonexOne remembers each server's roles for 5 minutes. Click Refresh roles to load them again. If it says Could not refresh roles: the bot isn't a member of..., add the bot back from the Discord servers page.
Someone's nickname isn't changing. See Set nicknames from the roster. Discord never lets a bot rename the server owner, or anyone whose roles are above the bot's.
Still stuck? Message us in the LonexLabs Discord with your community name, the Discord server, and the person who isn't syncing.
See also
Link Discord roles to departments and ranks
Give people Discord roles automatically for their department, rank, division, status, certifications and community roles, and take them away when that changes.
Connect your Discord server
Add the LonexOne bot to your main Discord server, put its role in the right place, and fix the messages you might see while connecting.
Set Discord nicknames from the roster
Have the bot rename members in Discord to match their callsign, name and rank, choose which department wins for people in several, and switch it off again.
Use more than one Discord server
Connect department and division servers alongside your main one, what the main server is used for, and how to switch which server is main.
Can't find what you need?
Open a ticket in our Discord and someone from the team will help. Found a bug, or missing a feature? Tell us on the feedback board.