# RoleLogic

> RoleLogic is a Discord bot for automatic role management. Server admins build no-code IF-THEN rules that add or remove roles based on the roles a member already has.

Canonical product site: https://rolelogic.faizo.net/

Canonical documentation: https://rolelogic.faizo.net/docs/

Complete plain-text documentation: https://rolelogic.faizo.net/docs/llms-full.txt

## Start here

- [Discord role automation documentation](https://rolelogic.faizo.net/docs/): Product overview, capabilities, and paths into the documentation.
- [Quick start](https://rolelogic.faizo.net/docs/quick-start): Invite RoleLogic, position its role, create a rule, and test it.
- [Plans and pricing](https://rolelogic.faizo.net/docs/plans): Current free and paid quotas.
- [FAQ](https://rolelogic.faizo.net/docs/faq): Setup, permission, billing, privacy, and cross-server answers.
- [Troubleshooting](https://rolelogic.faizo.net/docs/guides/troubleshoot-discord-role-bot): Diagnostic flow for rules that do not assign or remove roles.

## Core behavior

- A rule consists of one primary condition, up to 9 additional AND conditions, and actions that add roles, remove roles, or do both.
- The 9 condition types are Has Some Roles, Has All Roles, Lacks Some Roles, Lacks All Roles, Exactly N Roles, At Least N Roles, At Most N Roles, More Than N Roles, and Less Than N Roles.
- Rules can cascade when one rule's action makes another rule match. Processing stops after 100 passes as a safety limit.
- Role changes trigger evaluation automatically. Bursty changes are grouped for about 5 seconds on Free and 1.5 seconds on Premium.
- The background safety sweep runs about every 10 minutes on free servers and every 2 minutes on premium servers.
- A new or updated rule can take up to 1 hour to activate through scheduled processing; the dashboard play control can start it immediately.

## Current quotas

| Plan | Rules per server | Integrations / role links per server | Cross-server destinations |
| --- | ---: | ---: | ---: |
| Free | 2 | 2 | 2 |
| Tier 1 ($2/month) | 12 | 12 | 10 |
| Tier 2 ($5/month) | 38 | 38 | 10 |
| Tier 3 ($7/month) | 76 | 76 | 10 |
| Tier 4 ($10/month) | 132 | 132 | 10 |
| Tier 5 ($14/month) | 210 | 210 | 10 |

Paid totals include the 2 base slots plus the tier's allocated slots. Paid quota can be distributed between servers; each server retains its base slots. Quota reassignment has a 7-day cooldown.

Other limits:

- 10 conditions per rule (1 primary plus 9 AND conditions)
- 2 action types per rule (add and remove)
- 250 roles per condition or action
- 100 cascading evaluation passes
- 1,000 users per role link on free; up to 30,000,000 on premium

## Discord requirements

- RoleLogic needs the Manage Roles permission.
- Its server role must be above every role it adds or removes.
- It cannot modify the server owner's role, roles above itself, or integration-managed roles.
- Webhook notifications additionally require Manage Webhooks in the selected channel.
- Cross-server actions require RoleLogic and the member to be present in both servers, with correct hierarchy and permission in the destination server.

## Practical guides

- [Verification role automation](https://rolelogic.faizo.net/docs/guides/discord-verification-role-automation): Add member access and remove temporary roles after another verification system assigns a Verified role.
- [Booster role rewards](https://rolelogic.faizo.net/docs/guides/discord-booster-role-rewards): Derive VIP and perk roles from Discord's built-in Server Booster role.
- [50+ rule templates](https://rolelogic.faizo.net/docs/guides/common-scenarios): Verification, tiers, rewards, staff, access, gaming, subscriptions, cosmetics, and cross-server patterns.
- [Best practices](https://rolelogic.faizo.net/docs/guides/best-practices): Naming, priorities, testing, conflict prevention, and quota efficiency.

## Concepts and features

- [Rules](https://rolelogic.faizo.net/docs/concepts/rules)
- [Conditions](https://rolelogic.faizo.net/docs/concepts/conditions)
- [Actions](https://rolelogic.faizo.net/docs/concepts/actions)
- [Discord role hierarchy](https://rolelogic.faizo.net/docs/concepts/role-hierarchy)
- [Visual rule builder](https://rolelogic.faizo.net/docs/features/rule-builder)
- [Testing sandbox](https://rolelogic.faizo.net/docs/features/testing-sandbox)
- [Webhook notifications](https://rolelogic.faizo.net/docs/features/webhooks-logging)
- [Cross-server roles](https://rolelogic.faizo.net/docs/features/cross-guild)
- [Activity log](https://rolelogic.faizo.net/docs/features/activity-log)

## Technical reference

- [Conditions reference](https://rolelogic.faizo.net/docs/reference/conditions-reference): Exact matching behavior and truth tables.
- [Webhook placeholders](https://rolelogic.faizo.net/docs/reference/placeholders-reference): Available dynamic variables and examples.
- [Limits and quotas](https://rolelogic.faizo.net/docs/reference/limits-reference): Current constraints and processing timing.
- [Role Link API](https://rolelogic.faizo.net/docs/reference/role-link-api): Plugin contract, token authentication, user-management endpoints, chunked uploads, validation, and errors.

## Support

- [Support options](https://rolelogic.faizo.net/docs/support)
- [Discord support server](https://discord.gg/2wB7rHRDg2)