User Group Repository

To work with the with UserGroup Repository, use the following Facade:

use Statamic\Facades\UserGroup;

Methods#

Methods	Description
`all()`	Get all User Groups
`find($id)`	Get User Group by `id`
`queryUsers()`	Query Builder for Users in a Group
`make()`	Makes a new `UserGroup` instance

UserGroup::find('admin');

UserGroup::find('editors')
    ->queryUsers()
    ->get();

UserGroup::find('admin')
    ->queryUsers()
    ->where('avatar', true)
    ->get();

Start by making an instance of a user group with the make method. You can pass the handle into it.

$group = UserGroup::make('admin');

You may call additional methods on the group to customize it further.

$group
    ->title('Administrators')
    ->roles($roles); // array of role handles

Finally, save it.

$group->save();