FAQ & Troubleshooting
Find answers to common questions and solutions for issues.
Getting Started
What is RoleLogic?
RoleLogic is a Discord bot that automatically manages roles. You create IF-THEN rules like "If member has Booster → add VIP," and RoleLogic handles it 24/7.
Is RoleLogic free?
Yes. The free plan includes:
- 2 rules per server
- All features (conditions, actions, sandbox, logs)
- 5 cross-server links
Need more rules? See Plans & Pricing.
What permissions does RoleLogic need?
Only "Manage Roles". RoleLogic cannot read messages, access DMs, or see any private information.
Is my data safe?
Yes. We only store Discord IDs and your rule configurations. We don't store messages, passwords, or personal information. See our Privacy Policy for details.
Rules & Features
How many rules can I create?
- Free: 2 rules per server
- Premium: Up to 210 rules (varies by tier)
See Plans & Pricing for tier details.
Can rules trigger other rules?
Yes, this is called cascading. Example:
- Rule A: If has Gold → add Silver
- Rule B: If has Silver → add Bronze
When someone gets Gold, both rules fire automatically. RoleLogic limits this to 100 passes to prevent infinite loops.
What condition types are available?
| Condition | Matches When |
|---|---|
| Has Some Roles | Member has ANY selected role |
| Has All Roles | Member has EVERY selected role |
| Lacks Some Roles | Member is missing ANY selected role |
| Lacks All Roles | Member has NONE of the selected roles |
| Exactly N | Member has exactly N selected roles |
| At Least N | Member has N or more selected roles |
| At Most N | Member has N or fewer selected roles |
| More Than N | Member has more than N selected roles |
| Less Than N | Member has fewer than N selected roles |
Can I add AND remove roles in the same rule?
Yes. Use "Add Combined Action" to add some roles AND remove others in one rule.
How quickly do changes happen?
- Real-time: Rules trigger immediately when roles change
- Background sync: Every 10 minutes to catch any missed changes
- Debounce: 10-second delay to batch rapid changes
Troubleshooting
My rule isn't working
Check these in order:
- Is the rule enabled? Check the toggle in the dashboard
- Is the role hierarchy correct? RoleLogic's role must be ABOVE roles it manages
- Does the condition match? Test in the sandbox with exact roles
- Does RoleLogic have permissions? Verify "Manage Roles" is granted
- Is there a conflict? Another bot or moderator might be reverting changes
"Cannot manage this role"
The role is above RoleLogic in the hierarchy.
Fix:
- Go to Discord Server Settings → Roles
- Find the "RoleLogic" role
- Drag it ABOVE roles you want to manage
- Save
My rule keeps getting stopped
RoleLogic stops rules when it detects conflicts (100+ reverted actions per hour).
Common causes:
- Another bot fighting over the same role
- A moderator manually reverting changes
- Two of your rules conflicting
Fix: Identify the conflict, resolve it, then re-enable the rule.
Rule works for some members but not others
Possible causes:
- Role hierarchy only allows some roles to be managed
- Cross-server rule: member isn't in both servers
- Unusual role combination causes different condition to match
Fix: Test in sandbox with the exact role combination.
Changes keep reverting
Another system is undoing RoleLogic's changes.
Check:
- Other bots managing the same roles
- Moderators manually changing roles
- Discord integrations affecting roles
- Your own rules conflicting
Webhook notifications not appearing
Check in order:
- RoleLogic needs "Manage Webhooks" permission in the channel
- Webhook must be attached to an enabled rule
- Rule must actually be triggering
Can't see my server in the dashboard
- Verify you have Administrator or Manage Roles permission
- Make sure RoleLogic is invited to the server
- Try logging out and back in
Changes are delayed
Normal delays:
- Debounce: 10 seconds
- New rule activation: up to 1 hour for full propagation
For longer delays, check Discord status.
Cross-Server
Can RoleLogic manage roles across servers?
Yes. Create rules that affect roles in other servers where RoleLogic is present.
Example: When someone gets "VIP" in Main Server, add "VIP Access" in Lounge Server.
Cross-server action not working
Requirements:
- RoleLogic must be in BOTH servers
- Member must be in BOTH servers
- Role hierarchy must be correct in the TARGET server
- "Manage Roles" permission needed in both servers
Premium & Billing
How do I upgrade?
- Open Upgrade in your dashboard
- Choose a tier
- Subscribe through Patreon
- Quota syncs within 5 minutes
What happens if I downgrade?
Rules are deactivated, not deleted. Most recent rules stay active within your new quota. If you upgrade again, deactivated rules reactivate.
Can I move quota between servers?
Yes, but there's a 7-day cooldown after assigning quota to prevent abuse.
How do I cancel?
Cancel through Patreon anytime. Features remain active until the billing period ends.
Refunds?
Available within 7 days through Patreon.
Other Bots
Does RoleLogic work with other bots?
Yes. When other bots (MEE6, Carl-bot, etc.) change roles, RoleLogic evaluates if your rules apply.
Warning: Avoid bots managing the same roles. They can conflict.
What happens during Discord outages?
Changes may be delayed but are queued automatically. Nothing is lost.
Privacy & Security
What data does RoleLogic store?
Stored:
- Discord user IDs
- Server IDs
- Role IDs
- Rule configurations
- Activity logs
NOT stored:
- Messages or channel content
- DMs or passwords
- Payment info (Patreon handles this)
How do I delete my data?
- Remove RoleLogic from your server (deletes server data)
- Contact support for complete deletion
- Revoke dashboard access in Discord settings
Is RoleLogic secure?
Yes. We use:
- AES-256 encryption
- Secure OAuth2 via Discord
- Automatic backups
- Minimal permissions
Still Need Help?
- Test in the sandbox — Many issues can be diagnosed by testing
- Check the Activity Log — See what's happening with your rules
- Search documentation — Use the search bar
- Join the support server — Get help from the community
See Support for contact options.