# Roles and the capability matrix

URL: https://kywi-docs-production.up.railway.app/governing/roles-and-the-capability-matrix
Type: docPage

Six roles form one strict ladder, and every capability — content actions and every admin surface alike — reduces to a minimum-role floor on it.

Six roles form one strict ladder — **super admin**, **site admin**, **editor**, **author**, **reader**, and **deny**, from most to least privileged — and every "can this role do X" check in Kywi reduces to a minimum-role floor on that ladder. There's no per-capability toggle a site admin configures anywhere; a role either clears the floor for an action or it doesn't.

## The capability matrix

The minimum role each action needs, generated from the same capability catalog and the same check the server enforces on every request — not a hand-maintained table that can drift from what actually runs.

## A visible control is not a granted one

The Unpublish action and the Archived option on a content item's status field are shown to every role — the admin doesn't hide either one below site admin. Whether the action actually succeeds is a separate question: the editor ladder has no move out of published at all, so an editor who clicks Unpublish, or picks Archived, on a published page is refused by the server even though the control was right there and clickable. Seeing a button is not the same as clearing its floor.

## When a role change takes effect

A user's role travels inside their access token rather than being looked up fresh on every request, and that token is short-lived. Change someone's role and it reaches them the next time their token refreshes — within minutes, in the ordinary course of using the admin, but not the instant you save the change. If a role change needs to apply right now, have that person sign out and back in.

Where these roles are assigned per user and per site is [Managing users, roles and site access](/governing/managing-users-roles-site-access/). The queue the editor→published floor gates is [Reviewing and approving submissions](/governing/reviewing-and-approving-submissions/); the one door around both the queue and the ladder above is [Bypassing the queue: who can transition directly](/governing/bypassing-the-queue-who-can-transition-directly/).
