Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Group Member entry
How-to guide

Manage group membership

Managing group membership involves both the standard UI for small changes and Data Loader for bulk operations. The steps below cover both paths plus the audit workflow that keeps groups clean.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated May 19, 2026

Managing group membership involves both the standard UI for small changes and Data Loader for bulk operations. The steps below cover both paths plus the audit workflow that keeps groups clean.

  1. Identify the group

    Setup > Public Groups or Setup > Queues. Find the target group. Note the Group Id for SOQL or Data Loader operations.

  2. Add individual member through UI

    Edit the group, search for the user or sub-group in the Selected Members area, save. The change is immediate.

  3. Bulk add through Data Loader

    Export current GroupMember rows for the group. Prepare a CSV with GroupId and UserOrGroupId for new members. Insert via Data Loader. Confirm row count matches expectations.

  4. Verify access

    Use Login As to impersonate a new member. Confirm they have the access the group grants (folder visibility, record sharing, queue ownership).

  5. Document group purpose

    For each group, capture the purpose, the membership criteria, and the access it grants in a wiki or spreadsheet. Without documentation, future admins inherit a black box.

  6. Audit quarterly

    Run SELECT Group.Name, COUNT(Id) FROM GroupMember GROUP BY Group.Name. Identify oversized groups for review. Confirm each member still needs the access.

  7. Remove stale members

    For users no longer needing access, remove through the UI for small changes or Data Loader delete for bulk. Deactivated users do not need group removal; they cannot access the org regardless.

Key options
Add user memberremember

Single user added to the group. The most common operation.

Add group member (nested)remember

Another group added as a sub-group. Cascading membership; useful for shared organizational structures.

Add role memberremember

A role added. All users with that role inherit the group access.

Add role-and-subordinates memberremember

Role plus everyone below in the hierarchy. Common for management-level group inclusion.

Bulk through Data Loaderremember

Insert or delete GroupMember rows in bulk. The only practical path for hundreds of changes.

Gotchas
  • Role-and-Subordinates groups are not editable directly; membership comes from the UserRole table. Manual edits fail.
  • Nested groups cascade at access time. Adding a user to a deeply nested child group can grant unexpected access through multiple parent references.
  • Manage Public Groups permission is sensitive. Over-permissive assignment lets users grant themselves access. Audit the permission set assignments.
  • Deactivated users remain as GroupMember rows. Cleanup is cosmetic; the deactivated user cannot access the org regardless.
  • Bulk delete through Data Loader is irreversible. Test with a small batch and confirm impact before processing thousands of removals.

See the full Group Member entry

Group Member includes the definition, worked example, deep dive, related terms, and a quiz.