Permissions

Pro Feature

Permissions are the individual abilities you tick when building a role — view entries, edit assets, manage users, and so on.

Hot Tip!

Permissions get bundled into Roles, which you assign to users or user groups. Developers registering new abilities in PHP should see Custom Permissions.

Overview#

A permission is a single capability, identified by a string handle (e.g. edit blog entries). You don't assign permissions directly to users — you add them to a role, then attach that role to users or groups.

Out of the box Statamic ships with the matrix below. Wildcard handles like {collection} or {site} expand once per matching item (one permission per collection, site, etc.).

Statamic's native permissions#