How ranks and the permission system work in Crewly
Ranks are the foundation of how Crewly controls access. Every member has a rank, and every rank has a set of permissions that determine what that member can see and do.
Ranks map directly to your Roblox group roles. When you set up Crewly, you map each Roblox role to a Crewly rank. When sync runs, members are assigned the Crewly rank that corresponds to their Roblox role.Each rank has:
A name and colour — shown throughout the UI as a badge
A level — determines hierarchy. Higher level = higher rank. Must be unique per org.
A set of permissions — controls what members at this rank can do
Every organisation has one Owner rank. It is permanent and cannot be deleted, modified, or bypassed. The Owner rank has all permissions enabled.
The Owner rank is sacred. No action in Crewly — including direct database changes via the Supabase dashboard — should modify or remove it. Doing so may make your organisation inaccessible.
Go to Settings → Manage Ranks (under the Rank nav item) to:
Create new ranks
Edit rank names, colours, and levels
Configure permissions per rank
View member distribution across ranks
See which permissions each rank has enabled
The rank hierarchy visualiser on the Manage Ranks page shows your ranks ordered from highest to lowest level with member counts per rank. Click any rank to expand its full permission breakdown.
The core rank system handles direct rank assignments. If you need formal promotion workflows — eligibility requirements, promotion requests, trial periods, and approval queues — enable the Rank plugin.
Rank plugin
Learn about promotion workflows and eligibility requirements
