Email groups

1. Review the Groups tab — each row shows Name, Google Workspace email, and Members.
2. Read the stage badge — Unlinked, Link pending, Link failed, or Google Workspace-linked.
3. Open a group name to review Members and add or remove people.

Unlinked groups stay in Opal only until you connect them to Google Workspace.

1. Open an unlinked group from Email groups.
2. Open the header actions menu and choose Connect to Google Workspace.
3. Select the matching Google Workspace group from the list.
4. Choose Refresh Google Workspace groups when the list looks stale.
5. Choose Connect.

After a successful link, Google Workspace owns the group name and address; Opal owns membership.

Drift appears when Opal membership and Google Workspace membership disagree.

1. Open Email groups and choose the Drift tab.
2. Open the header actions menu and choose Check for drift.
3. Review unresolved rows — missing_in_google means Opal expects an address Google does not have yet; extra_in_google means Google has an address Opal does not expect.
4. Fix a row with Add to Google Workspace or Remove from Google Workspace, or mark it Ignored / Manual when you handled it another way.
5. From a linked group detail page, choose Review drift to open the same queue filtered to that group.

1. From Email groups, open a group and use Add member to search by name, email, section, or membership type.
2. Choose Remove on a member row when they should leave the list.
3. From Players, open a member and choose the Email groups tab.
4. Use Add email group or Remove on a specific group.

Archived members cannot be added to email groups until they are unarchived.

The Outbox shows integration jobs for Clerk and email groups.

1. Open Admin → Outbox from the sidebar System group.
2. Review Pending / processing for work still running.
3. Review Failed for rows that need attention — read the kind label (for example Email group member add).
4. Choose Retry on a failed row to send it back to pending.
5. Confirm the row moves to Recent successes after the worker finishes.

If failures repeat, note the kind and member involved before escalating to engineering.