Groups

On this Page
Docs Menu

The Groups page lists all of the user groups on your Looker instance. Placing users into groups is helpful for managing Spaces access and other permissions.

Consider creating groups related to the type of content they handle. Users can filter the Top Content by group so good group design can help them find the content they need.

Viewing and Searching Groups

The table of groups that appears on the page shows basic information about each group:

Column Definition
ID A group ID assigned by Looker at the time of group creation
Name The name of the group that was entered when the group was created
Roles A list of roles assigned to the group
Members The number of users that are a part of the group
Actions Actions you can take for a group

You can sort the table by either the ID or Name column by clicking on those column’s headers.

Adding Groups

To add a group, simply click the Add Group button in the upper left of the page.

Looker will display a dialog where you can type the name of the new group. After you hit the Create button, Looker adds the group to the Groups page. You can then edit the group to add users or roles.

Editing Groups

To edit a group, click the Edit button on the right hand side of its row. There you’ll be able to adjust several settings:

Roles

The roles section lists all of the roles that have been created in your instance, along with an empty circle or check to indicate whether or not that role has been added to the group you’re viewing.

To assign one or more permissions roles to a group, click the Edit link next to the role you want to add to the group. This will bring you to the page for that role. If you scroll down you’ll be able to add any groups you like to the role. See the Roles page for more information on configuring roles, or the Permissions Management page for a broader discussion of Looker permissions.

If the group you’re editing was automatically created as part of an LDAP integration, you will not be able to add roles here. This helps to ensure that your LDAP groups continue to be your single source of truth. Instead, use the instructions provided on the LDAP page.

Members

The members of the group are listed in the Members section. Members can be individual users or other groups. If enough members are part of the group the Next and Prev buttons will allow you to view additional pages of members. Otherwise, these buttons are grayed out.

Above the list of members is a search box you may use to filter the list of members. Looker will display any group member whose name or email address contains your search.

Add

To add a member type their name into the search box and select their name from the search results. You can repeat this as many times as necessary. When you’re done click the Add button to add the members to the group. It is also possible to add users to a group from the Users page.

Remove

To remove a member, click the checkbox next to their name, then click the Remove button.

Done

When you’re finished editing a group click the Done button in the upper left of the page.

Deleting Groups

To delete a group, click the Delete button on the right hand side of its row. Looker displays a confirmation dialog before you delete the group.

Deleting a group is irreversible! Deleting a group while it is still in use can impact a wide variety of user permissions, which can prevent users from accessing the Spaces or features they are used to.

Still have questions?
Go to Discourse - or - Email Support
Top