See the Grav Admin FAQ, to learn how to manage users
By default, Grav does not provide any group. You need to define them.
Groups are defined in the user/config/groups.yaml file. If that file does not exist yet, create it.
Here’s an example of a user groups definition:
readableName: 'Registered Users'
description: 'The group of registered users'
readableName: 'Paid Members'
description: 'The group of paid members'
description: 'The group of administrators'
Here we define 3 groups.
Every user can be assigned to a group.
to a user’s yaml file under
You can add multiple groups:
You can also edit a user’s group information through the Admin Plugin.
Users assigned to a group inherit the group permissions. You can for example define a group that has permission
site.paid by adding:
to the group definition in
When a user is assigned to that group, it will inherit the site.paid: true permission.
When a user belongs to multiple groups, it's enough that a group provides a permission, and it will be added to the user's permissions.
You can fine-tune the permissions on a user level too, as usual. With groups, you can define a global permission and deny it on a user level, by adding
to a user’s yaml file.
See the Grav Admin FAQs to learn more about available Permissions
Found errors? Think you can improve this documentation? Simply click the Edit link at the top of the page, and then the icon on Github to make your changes.