Permissions
The two kinds, and why they are not interchangeable.
Permissions
There are two kinds, granted separately and checked in different places.
Global permissions
Held site-wide, bound to no path. access:admin, read:users, write:users,
manage:users, read:groups, write:groups, manage:groups, read:audit,
read:metrics, manage:theme, manage:storage, manage:sites, read:webhooks,
manage:webhooks, manage:system. That list is the whole of it.
manage:system bypasses every check everywhere.
A site’s settings are split across three permissions that do not overlap: manage:sites for its
general settings, manage:theme for its appearance and manage:storage for where its content
is kept. Changing all of them takes all three.
Page rule permissions
Bound to paths, and to locales and sites. A group grants them through rules: each rule names some
permissions, says how it addresses pages, and says what it does with them.
| Mode | What it means |
|---|---|
ALLOW |
Grant these, unless something more specific denies |
DENY |
Refuse these |
FORCEALLOW |
Grant these, and let nothing override it |
Important
A page permission cannot be enforced by a route-level check — that reads the group-wide list only,
so declaring one there refuses everybody.
write:pages either — a rule grants the exact strings itnames.