Turn on group sync
Open the Google Workspace connection
Edit the configuration
Exclude groups you don't need
Save
Settings
Group sync
Group sync controls whether this connection brings in groups.- Don’t sync groups: Iru syncs users only.
- Sync groups and membership: Iru syncs users, groups, and each group’s members.
Exclude group IQL expression
The Exclude group IQL expression skips every group the expression matches. Leave it empty to sync every group. The expression can use two fields:- name: the group’s name.
- memberCount: how many direct members the group has.
memberCount < 2 || name.startsWith("test-") skips groups with fewer than two members and groups whose names start with test-. See IQL expressions.
Review the groups Iru finds
Open the connection, go to the Sync tab, and select Review Groups. This list shows every group the directory reports, including the ones Iru is not syncing, so you can check the exclusion expression against real groups.- Ignore stops syncing the group. If it already synced, it stays in Iru with its current members and access, and you manage it like any other group.
- Sync this group makes the directory the source of truth again. The directory’s members replace the group’s members in Iru, so anyone added by hand is removed, along with any access they had through the group.
- Delete group from Iru appears once Iru has stopped syncing a group it created. Deleting removes the group and its members from Iru and cannot be undone. Members lose any access they had through the group. If you later select Sync this group and the directory still reports the group, it comes back on the next sync.
See the groups in Iru
The Effective Groups tab lists the groups this connection has created in Iru.- Synced: Iru keeps this group and its members up to date.
- Not in source: the directory stopped reporting this group. It was deleted there, filtered out, or the connection was removed. Iru keeps the group and its members as they were, stops syncing it, and hands it to you to manage.
Considerations
Your directory owns synced groups
Your directory owns synced groups
Sync never deletes groups
Sync never deletes groups
Only synced users become members
Only synced users become members
Nested groups carry over
Nested groups carry over
A sync applies groups only when it reads them all
A sync applies groups only when it reads them all
Large directories take longer to sync
Large directories take longer to sync
Best practices
Start with an exclusion expression
Check Review Groups before relying on a group
Make membership changes in Google Workspace
Ignore a group instead of deleting it
Troubleshooting
Groups don't appear after turning on group sync
Groups don't appear after turning on group sync
- No sync has run since you turned on group sync.
- The connection was made before group sync was available and can’t read groups.
- The Exclude group IQL expression matches the groups.
- Select Sync now, then check Review Groups.
- Reconnect the Google Workspace connection.
- Check the group’s status on Review Groups. If it shows Excluded by filter, edit the expression.
A group is missing members
A group is missing members
- The missing people are not users this connection syncs, for example because they are outside the Org unit path.
- The missing people are outside your Google Workspace domain.
- Check that each missing person appears on the Effective Users tab.
- Widen or clear the Org unit path if they should be synced.
You can't edit a group's members
You can't edit a group's members
- Iru syncs the group from the directory.
- Change the members in Google Workspace and select Sync now.
- To manage the group in Iru instead, select Ignore on Review Groups.