Skip to main content

Groups (People & Permissions)

Genesys Cloud has two distinct group systems that serve completely different purposes. This page covers Directory Groups — the groups used for access control, role assignment, queue membership, and communication. Do not confuse these with Work Teams (WFM-specific groupings) or group workspaces (document sharing). All group management lives under Admin → Directory → Groups.


Navigation Path

TaskPath
Manage all groupsAdmin → Directory → Groups
Create a groupAdmin → Directory → Groups → Add Group
Edit a groupAdmin → Directory → Groups → click group name
Assign roles to a groupAdmin → Directory → Groups → select group → Roles tab

Required permissions:

PermissionRequired For
Directory > Group > ViewViewing groups
Directory > Group > EditEditing groups and managing membership
Directory > Group > AddCreating new groups
Directory > Group > DeleteDeleting groups

1. Two Types of Groups

Genesys Cloud has two fundamentally different group types, each with distinct behavior and use cases.

General Groups

Manual or rule-based groups used for communication, role assignment, and directory organization.

FeatureDetail
MembershipAdded manually one at a time, or automatically via membership rules based on profile data and org hierarchy relationships
Chat roomGenesys Cloud automatically creates a persistent chat room with the same name when a general group is created
Profile pageHas a group profile page showing members, contact info, and group photo
RolesCan have roles assigned directly — all group members inherit those roles and division scopes
Group typesCan be designated as Official (work-related) or Social
DeletionDeleting a general group does NOT delete the associated chat room. Chat rooms cannot be deleted.

When to use general groups:

Use CaseExample
Role assignment at scaleCreate "Outbound Supervisors – Monterrey" group, assign the Supervisor role + Monterrey division once — all members inherit it automatically
SME identification"SBC Experts" group makes specialists findable via directory search
Project teamsTemporary groups for cross-functional projects
Location-based teams"Monterrey Floor 2" for announcements and group chat
Queue membership via Bullseye routingAssign groups to bullseye routing rings in queue configuration

Skill Expression Groups

Dynamic groups whose membership is automatically managed by the system based on ACD skill and language proficiency conditions.

FeatureDetail
MembershipFully automatic — the system adds/removes members when their ACD skill assignments or proficiency ratings change
Update speedMembership changes take effect within approximately 1 minute of a skill change
Chat roomNo chat room is created for skill expression groups
Primary useDynamically populating queue membership or bullseye routing rings based on agent skills
Inactive membersThe Membership tab always shows total member count including inactive users

Example skill expression:

ExpressionMeaning
English > 3Includes all agents whose English language skill proficiency is greater than 3
Spanish >= 4 AND SBC_Support >= 2Includes agents with both Spanish proficiency ≥ 4 and SBC Support skill ≥ 2

📌 Key distinction: General groups are managed by admins or rules based on profile data. Skill expression groups are managed entirely by the ACD skill engine based on skill assignments. Use skill expression groups when your queue membership should automatically track skill levels.


2. Group Limits

LimitValue
General groups per org (recommended max)500
Skill expression groups per org300 (contact Customer Care to exceed)
Primary conditions per skill expression group10
Subconditions per primary condition10
Groups a single user can belong toUp to 100 official + 100 social (200 total)
Individual members added manually (recommended max)1,000 per group

3. Group Membership — General Groups

Manual (Individual) Membership

Add users one at a time via the group's Membership tab.

Admin → Directory → Groups → select group → Membership tab → Edit → Individuals tab → search and add

📌 Members added individually are not affected by changes to membership rules. Manual additions are permanent until explicitly removed.


Automatic Membership Rules

Rules automatically add or remove members based on profile data and org hierarchy relationships.

Rule TypeExample
Profile tags/certificationsAll users tagged with "Cisco"
Reporting relationship — SuperiorsEveryone in the management chain above a specific person
Reporting relationship — SubordinatesAll direct reports below a specific manager
Inclusions / ExclusionsInclude everyone from a rule, then exclude specific individuals

Admin → Directory → Groups → select group → Membership tab → Edit → Inclusions tab → define rule


Owners vs. Members

RoleCapabilities
OwnerFull editing rights — can modify group settings, membership, and roles
MemberLimited rights — can participate in group chat, appears in group directory

📌 When you create a group, you are automatically its owner. If you create a group on behalf of someone else and don't want editing rights, remove yourself as an owner after creation. If you remove yourself as owner, you lose editing rights unless you have the Directory > Group > View and Directory > Group > Edit permissions assigned to your role.


4. Group Membership — Skill Expression Groups

Admin → Directory → Groups → Skill Expression tab → select group → Membership tab → Build Skill Expression

Membership is built by defining conditions using ACD skills and language proficiencies with relational operators (greater than, equal to, greater than or equal to, etc.) and logical operators (AND, OR).

⚠️ Skill expression groups are dynamic. If you modify an agent's ACD skill assignments or proficiency ratings, their membership in any skill expression group that references that skill updates automatically within approximately 1 minute.


5. Assigning Roles to Groups

One of the most powerful uses of general groups is bulk role assignment. When you assign a role (with a division) to a group, every current and future member of that group inherits that role scoped to that division automatically.

Admin → Directory → Groups → select group → Roles tab → Assign Roles → select role → select division → Save

BehaviorDetail
New membersAutomatically inherit all roles assigned to the group upon joining
Removed membersLose all roles inherited from the group upon removal
Role editingRoles inherited from a group cannot be edited on an individual user's Roles tab — you must edit the group or remove the user from the group
Division-Aware Role ManagementIf enabled org-wide, admins can only assign roles to groups within divisions they themselves have access to

📌 Best practice: For large teams with shared permissions (e.g., all Monterrey supervisors), use a group + role assignment instead of assigning roles to each user individually. This dramatically reduces maintenance overhead when staff changes occur.


6. General Group Types: Official vs. Social

When creating a general group, you designate it as Official or Social. This affects how users can search and filter groups in the directory.

TypeUse CaseWorkspace Eligible?
OfficialWork-related — teams, departments, projects, queues✅ Yes — can be added to group workspaces
SocialNon-work — interest groups, social clubs❌ No — social groups cannot be workspace members

7. Groups and Chat Rooms

BehaviorDetail
Creating a general groupAutomatically creates a persistent chat room with the same name
Deleting a general groupDeletes the group but not the chat room — chat rooms cannot be deleted
Skill expression groupsNo chat room is created

📌 If you create test groups or temporary groups, be aware that their associated chat rooms persist indefinitely even after the group is deleted.


8. Limits & Operational Notes

ItemGuidance
Keep org group count under 500Genesys recommends no more than 500 groups per org for performance
Limit individual manual members to 1,000For groups with larger populations, use membership rules instead
Disable group calls when adding membersFor best results, temporarily disable group calls while bulk-adding members
Workspace access via groupsWhen an official group is added to a workspace, any user added to the group automatically gains workspace access — use carefully for sensitive files

Quick Comparison: General vs. Skill Expression Groups

FeatureGeneral GroupSkill Expression Group
Membership managementManual or profile/hierarchy rulesAutomatic via ACD skill conditions
Chat room created✅ Yes❌ No
Profile page✅ Yes✅ Yes
Role assignment✅ Yes✅ Yes
Queue/bullseye routing✅ Yes (manual)✅ Yes (dynamic)
Max per org500 (recommended)300
Membership update speedOn admin action or rule trigger~1 minute after skill change

Last verified against Genesys Cloud Resource Center – March 2026