Frequently Asked Questions
Find answers to the most common questions about RoleLogic.
Getting Started
What is RoleLogic?
RoleLogic is a Discord bot that automatically manages roles for your server members. You create simple IF-THEN rules like "If member has Booster role, then add VIP role," and RoleLogic handles the automation 24/7 without any manual intervention.
Is RoleLogic free to use?
Yes! RoleLogic has a free plan that includes:
- 2 rules per server — enough for basic verification or reward systems
- All 9 condition types — full access to every matching option
- All action types — add and remove roles freely
- Testing sandbox — test rules before going live
- Activity log — track all configuration changes
- Webhook logging — notifications with RoleLogic branding
Premium plans are available if you need more than 2 rules per server.
How do I add RoleLogic to my server?
- Visit the RoleLogic website
- Click "Get Started Free" or "Add to Discord"
- Select your server from the dropdown
- Review the permissions and click "Authorize"
- Open the dashboard and log in with Discord
- Select your server and create your first rule!
The whole process takes less than 2 minutes.
What permissions does RoleLogic need?
RoleLogic only needs the "Manage Roles" permission. This allows it to add and remove roles from members.
What RoleLogic CANNOT do:
- Read your messages or channels
- Access DMs
- See member activity
- Access any private information
- Kick or ban members
- Modify server settings
RoleLogic is designed with minimal permissions for maximum security.
Is my data safe?
Yes. RoleLogic is built with privacy in mind:
What we store:
- Discord user IDs (for authentication)
- Server IDs (to know where your rules apply)
- Role IDs (to configure rules)
- Your rule configurations
What we DON'T store:
- Messages
- DMs
- Passwords
- Payment information (Patreon handles payments)
- Any content from your channels
We never sell or share your data. See our Privacy Policy for complete details.
Features & Capabilities
How many rules can I create?
| Plan | Rules per Server |
|---|---|
| Free | 2 rules |
| Tier 1 | 12 rules |
| Tier 2 | 28 rules |
| Tier 3 | 40 rules |
| Tier 4 | 58 rules |
| Tier 5 | 80 rules |
Most servers can accomplish their automation goals with just 2-12 rules by using smart rule design.
Can RoleLogic manage roles across multiple servers?
Yes! With cross-server actions, you can create rules that affect roles in other servers where RoleLogic is present. For example:
- Give "VIP Access" in your lounge server when someone gets "VIP" in your main server
- Sync staff roles across a server network
- Coordinate partner programs across communities
The free plan supports up to 5 linked servers.
How quickly do role changes happen?
Role changes happen in real-time:
- When a member's roles change, RoleLogic evaluates rules immediately
- Actions are applied within seconds
- A background sync runs every 10 minutes to catch any missed changes
There's a 10-second debounce to batch rapid changes efficiently.
Can I test rules before they go live?
Absolutely! The Testing Sandbox lets you:
- Select any combination of roles
- Click "Run Test"
- See exactly what roles would be added or removed
- Verify rule cascading behavior
Testing is completely safe—no real members are affected.
Can rules trigger other rules?
Yes, this is called cascading. For example:
- Rule A: If has "Gold", add "Silver"
- Rule B: If has "Silver", add "Bronze"
When someone gets Gold, Rule A adds Silver, which triggers Rule B to add Bronze. RoleLogic handles this automatically, with a safety limit of 100 cascade passes to prevent infinite loops.
How many conditions can I have per rule?
Each rule can have up to 10 conditions:
- 1 primary condition (required)
- Up to 9 additional AND conditions
All conditions must be true for the rule to trigger.
What condition types are available?
RoleLogic offers 9 condition types:
| Condition | Matches When |
|---|---|
| Has Some Roles | Member has ANY of the selected roles |
| 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 of the 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 both add and remove roles in the same rule?
Yes! Use the "Add Combined Action" feature to:
- Add some roles AND
- Remove other roles
All in a single rule. For example: "If has Promoted → add Staff AND remove Trainee"
How many roles can I include in one action?
Each action can include up to 250 roles. This is more than enough for any practical use case.
Troubleshooting
Why isn't my rule working?
Check these common causes in order:
- Is the rule enabled? — Look for the enabled toggle in the dashboard
- Is the role hierarchy correct? — RoleLogic's role must be above the roles it manages
- Does the condition actually 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
See the Troubleshooting Guide for detailed solutions.
Why can't RoleLogic manage certain roles?
Discord security rule: Bots can only manage roles below their own position.
To fix:
- Go to Discord Server Settings → Roles
- Find the "RoleLogic" role
- Drag it ABOVE the roles you want to manage
- Save and try again
My rule keeps getting stopped automatically. Why?
RoleLogic has a safety system that detects conflicts. If it sees the same role being added and removed repeatedly (100+ times in an hour), it automatically stops the rule.
Common causes:
- Another bot is fighting over the same role
- A moderator is manually reverting changes
- Two of your rules conflict with each other
To fix: Identify the conflict, resolve it, then re-enable the rule.
Why do I see "Cannot manage this role"?
The target role is above RoleLogic's role in the hierarchy. Go to Server Settings → Roles and drag RoleLogic's role higher.
Why aren't webhook notifications appearing?
Check these in order:
- RoleLogic needs "Manage Webhooks" permission in the channel
- The webhook must be attached to an enabled rule
- The rule must actually be triggering (test it first)
- Check if the channel has any permission overrides blocking webhooks
Premium & Pricing
What's the difference between free and premium?
| Feature | Free | Premium |
|---|---|---|
| Rules per server | 2 | Up to 80 |
| All condition types | ✅ | ✅ |
| All action types | ✅ | ✅ |
| Testing sandbox | ✅ | ✅ |
| Activity log | ✅ | ✅ |
| Cross-server links | 5 | Expanded |
| Webhook watermark | Included | Removed |
| Priority support | - | ✅ |
How much does premium cost?
RoleLogic offers multiple tiers through Patreon. Visit the Upgrade page in your dashboard to see current pricing. Plans can be changed or cancelled anytime.
How do I upgrade to premium?
- Open the Upgrade section in your dashboard
- Choose a tier that fits your needs
- Click to subscribe through Patreon
- Your quota syncs automatically within 5 minutes
Can I cancel my subscription?
Yes, cancel anytime through Patreon. Your premium features remain active until the end of your billing period, then revert to the free plan.
What happens to my rules if I downgrade?
Existing rules continue working! However:
- You cannot create new rules if you're over the free limit
- You'll need to delete rules to get back within quota before adding new ones
- No rules are automatically deleted
Is there a refund policy?
Refunds are available within 7 days per Patreon's terms. Contact Patreon support for refund requests.
Can I move my premium quota between servers?
Yes, but there's a 7-day cooldown after assigning quota to a server. This prevents abuse and ensures stability. Plan your allocation carefully.
Do you offer custom enterprise plans?
Yes! Contact us through the support server for custom plans if Tier 5 (80 rules) doesn't meet your needs.
Account & Security
How do I log into the dashboard?
Click "Login with Discord" on the dashboard. This uses Discord's official OAuth2 system:
- You log in through Discord directly
- We never see or store your password
- We only get your username, ID, and server list
- You can revoke access anytime in Discord settings
What data does RoleLogic store?
Stored (necessary for operation):
- Discord user IDs
- Server IDs
- Role IDs
- Rule configurations
- Activity log entries
- Session cookies
NOT stored:
- Messages or channel content
- DMs
- Passwords
- Payment details (Patreon handles payments)
- Voice activity
- Any personal information beyond Discord IDs
How do I delete my data?
Contact us through the support server to request data deletion. We process requests within 72 hours. You can also:
- Remove RoleLogic from your server (deletes server-specific data)
- Revoke dashboard access in Discord settings
Is RoleLogic secure?
Yes. Our security measures include:
- AES-256 encryption for sensitive data
- Secure OAuth2 authentication via Discord
- Automatic database backups
- Discord API best practices
- Minimal permission requirements
Technical Questions
Does RoleLogic work with other bots?
Yes! RoleLogic works alongside other bots. When another bot (like MEE6 or Carl-bot) changes a member's roles, RoleLogic evaluates if any of your rules apply.
Tip: Be careful with bots that manage the same roles. If Bot A adds a role and RoleLogic removes it, they can conflict. Design your automation to avoid overlapping responsibilities.
What happens during Discord outages?
During Discord API issues:
- Role changes may be delayed
- Operations are queued automatically
- Processing resumes when Discord recovers
- No changes are lost
Is there an API for RoleLogic?
RoleLogic is designed for end users through the dashboard. There's no public API for custom integrations at this time. All automation is configured through the visual rule builder.
Does RoleLogic work in DMs?
No. RoleLogic only operates within Discord servers where it's been invited. It cannot access or manage anything in DMs—that's not how Discord role management works.
What's the maximum server size RoleLogic can handle?
RoleLogic is designed to scale with servers of any size:
- Small servers (under 1,000): Instant processing
- Medium servers (1,000-10,000): Near-instant processing
- Large servers (10,000-50,000): Fast batch processing
- Very large servers (50,000+): Optimized for efficiency
Initial setup may take longer for very large servers, but ongoing real-time processing remains fast.
How often does RoleLogic sync with Discord?
- Real-time: Rules trigger immediately when roles change
- Background sync: Every 10 minutes to catch any missed changes
- Debounce: 10-second delay for batching rapid changes
Getting Help
Where can I get support?
Multiple options available:
- Documentation: You're reading it! Search for specific topics
- Support Server: Join our Discord for help from the team and community
- Troubleshooting Guide: Detailed solutions for common issues
- Support Page: Contact options for direct help
I found a bug. How do I report it?
Report bugs in our support server. Please include:
- What you expected to happen
- What actually happened
- Steps to reproduce the issue
- Screenshots if helpful
- Your server ID (if comfortable sharing)
Can I request new features?
We love hearing ideas! Share feature requests in our support server. While we can't implement everything, popular requests influence our development roadmap.
How do I get faster support?
- Search documentation first (your answer might be here!)
- Provide specific details about your issue
- Include server ID and rule configurations
- Describe what you've already tried
- Be patient and respectful
Didn't Find Your Answer?
If your question isn't covered here:
- Search the documentation — Use the search bar to find related topics
- Check the troubleshooting guide — Detailed solutions for common issues
- Test in the sandbox — Many questions can be answered by experimentation
- Visit the support server — Get help from the community
- Contact us directly — For account or billing issues
See the Support page for all contact options.