This is a method or sub-command of the Config command. It is not its own command.

This method of the config command can be used to check if features of Lurkr have been correctly configured either using the dashboard or some of the other methods of the config command.

The troubleshoot embed can tell you whether everything is configured correctly, if a features is turned off (and therefore won't be checked) or if there is a problem, what is causing it, letting you deduce how you can fix it!

Command Structure

/config troubleshoot

Possible Checks

Below is a list of checks that the troubleshoot command can perform and will alert you of.

This table can also show you in more detail what is meant by each error and how you can generally fix them!


Channel not found

The channel doesn't exist or never did exist.

Set a channel that does exist to Lurkr. Use channel ID's to tell exactly which channel should be used if there are duplicate names.

Invalid channel types

The channel can't be used in this context. For example, voice channels can't be leveling channels.

Set a channel that Lurkr does support, like normal text channels or forum channels.

Missing permissions on channel

Lurkr doesn't have necessary permission for the channel

Give Lurkr either server-wide or in the channel the needed permissions.

Role not found

The role doesn't exist or never did exist.

Set a role that does exist to Lurkr. Use role ID's to tell exactly which role should be used if there are duplicate names.

Role not editable

The role cannot be edited by Lurkr, and therefore can't be given to users.

This cannot be fixed as it happens with integration managed roles. Choose a different role.

Role hierarchy incorrect

Lurkr's top most role is below one or more of the roles you want to set, not allowing Lurkr to control those roles.

Either move the roles higher than Lurkr's highest role or the opposite. Learn about role hierarchy.


  • Manage Server(User)

  • N/A (Bot)


  • N/A

Last updated