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:
registered: icon: users readableName: 'Registered Users' description: 'The group of registered users' access: site: login: true paid: readableName: 'Paid Members' description: 'The group of paid members' icon: money access: site: login: true paid: true administrators: groupname: administrators readableName: Administrators description: 'The group of administrators' icon: child access: admin: login: true site: login: true
Here we define 3 groups.
Every user can be assigned to a group.
groups: - paid
to a user’s yaml file under
You can add multiple groups:
groups: - administrators - another-group
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:
access: site: paid: true
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
access: site: paid: false
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.