Player Groups: Segment Your Club Base
Player Groups: Segment Your Club Base
Section titled “Player Groups: Segment Your Club Base”Player Groups are IZI’s manual segmentation tool for your customer base. You create a named segment — for example, VIP, Tournament Roster, or Under-14 — add players to it, and then use that segment as the audience in tariff discounts, promo campaigns, and notification broadcasts. Groups live at the organization level and are instantly available across every club in your network: create once, apply everywhere. The player count in the groups table reflects members of that group who have visited the club you are currently working in. The assignment operation is atomic — adding multiple players to multiple groups either succeeds in full or rolls back entirely, with no partial states.
Where to find the section
Section titled “Where to find the section”Navigate to Marketing → Player Groups in the organization menu. Viewing the list requires the PLAYER_GROUP_READ permission at the organization level (OrgPermissions). Creating, editing, and deleting groups each require their own corresponding permissions: PLAYER_GROUP_CREATE, PLAYER_GROUP_EDIT, and PLAYER_GROUP_DELETE. Assigning players to a group is governed by a separate PLAYER_GROUP_ASSIGN permission at the club level (ClubPermissions).
What the groups table shows
Section titled “What the groups table shows”| Column | What it displays |
|---|---|
| Group | Group name with its icon |
| Description | Internal note (optional) |
| Players | Number of members in this club context |
| Updated | Date of the last change |
The table supports pagination (20 / 50 / 100 rows per page) and name search. Clicking a row opens the group card for viewing or editing.
How to create a group
Section titled “How to create a group”- Go to Marketing → Player Groups.
- Click Add in the top-right corner.
- Enter a Group Name — this field is required. Names must be unique within the organization; if a duplicate is detected, the system shows a
PlayerGroupNameDuplicateerror and does not save. - Optionally add a Description for internal reference.
- Click Save.
The group is created immediately and is ready to use in discount rules and campaigns.
How to add players to a group
Section titled “How to add players to a group”The group itself is an empty container. You can populate it in two ways.
Via the player profile. Open the relevant club, go to the Players section, find the player, and select groups from their profile. This is convenient for one-off changes to individual accounts. See Players overview for more on the player card fields.
In bulk. To assign multiple players to multiple groups at once, use the bulk operation from the player list view. The underlying assignPlayersToGroups operation is atomic and idempotent — reassigning a player who is already in a group does not produce an error.
To remove a player from a group, the reverse removePlayersFromGroups operation applies — also atomic and idempotent, scoped to the current club.
How to use groups in discounts
Section titled “How to use groups in discounts”Player groups integrate directly with tariff and product discount rules. To apply a discount to a segment:
- Go to club settings → Tariff Discounts (or Product Discounts).
- Create or open a discount rule.
- In the Player Groups field, select the target segment.
- Save the rule.
From that point the discount is applied automatically when an authenticated member of the group starts a session or places an order at that club. For the full mechanics of discount stacking and conditions, see Discounts and Promos.
How to use groups in notification campaigns
Section titled “How to use groups in notification campaigns”When creating a broadcast in the Campaigns section, the system asks you to define an audience. Player groups are one of the audience types: the campaign is sent to all members of the selected groups who have consented to receive notifications. You can select multiple groups for a single campaign.
Editing and deleting
Section titled “Editing and deleting”Editing. Click a row or the edit button on a group. You can change the name and description. The member list is managed through player profiles, not the group form itself.
Deleting. Use the trash icon in the table row. A confirmation dialog appears: “Are you sure you want to delete the group ‘{name}’? This action cannot be undone.” Technically, deletion is a soft-delete — data is retained internally. The group stops participating in discount calculations and no longer appears in campaign audience selectors.
Export
Section titled “Export”An export control sits in the top-right corner next to the Add button. Clicking it downloads a spreadsheet whose columns match the table: name, description, player count, and last-updated date.
Recommendations for organizing segments
Section titled “Recommendations for organizing segments”Groups perform best when there are few of them and each has a clear, non-overlapping purpose:
- By value. VIP customers, regular visitors, new players — different retention incentives for different lifecycle stages.
- By interest. FPS community, fighting-game regulars, esports competitors — enables more targeted promotions.
- By age or account type. Minors, corporate guests — different tariff conditions and permitted hours.
- By loyalty status. Tournament participants, pass holders, bonus program tiers.
Avoid creating too many overlapping groups — this complicates discount logic and makes it harder to trace which rule applied to a given session.
Permissions reference
Section titled “Permissions reference”| Action | Required permission |
|---|---|
| View group list | OrgPermissions.PLAYER_GROUP_READ |
| Create a group | OrgPermissions.PLAYER_GROUP_CREATE |
| Edit a group | OrgPermissions.PLAYER_GROUP_EDIT |
| Delete a group | OrgPermissions.PLAYER_GROUP_DELETE |
| Assign players to a group | ClubPermissions.PLAYER_GROUP_ASSIGN |
| View players in club context | ClubPermissions.PLAYER_GROUP_READ |
Roles and their permission sets are configured in the organization team management section.
Frequently asked questions
What are player groups in IZI?
Player groups are named segments of your customer base, assembled manually at the organization level. A single group is visible across all clubs in your network, so you can apply a consistent discount policy or notification campaign everywhere from one place.
How do player groups differ from filters or tags?
A group is persistent membership — a player stays in it until an admin explicitly removes them. A filter is a temporary view applied while browsing. Groups are stored in the database and available to other modules such as discounts and notification campaigns.
Can one player belong to multiple groups?
Yes. A player can be in any number of groups simultaneously. 'VIP' and 'Tournament Roster' are not mutually exclusive — a player can hold both memberships at once.
Do groups apply to the whole network or a single club?
Groups are created at the organization level and are visible across all clubs. The player count shown in the table reflects members who have visited the specific club you are currently viewing.
How do I assign a player to a group?
Open the player's profile in the Players section of a club and select the groups there. You can also use the bulk operation from the player list, which atomically adds multiple players to multiple groups in a single action.
Can I delete a group that still has players in it?
Yes. Deletion uses a soft-delete — data is preserved internally. Players are not removed from the system, but they stop receiving discounts or being included in campaigns tied to that group.
How do I apply a discount to a group?
Go to the club's tariff or product discount settings, create or open a discount rule, and select the player group as the condition. The discount then applies automatically whenever a member of that group starts a session or places an order.
Are player groups used in notification campaigns?
Yes. When creating a notification campaign you can select one or more player groups as the audience. The campaign is sent to all group members who have consented to receive notifications.
Is there a limit on the number of groups?
There is currently no hard cap on the number of groups in an organization. In practice, keeping the list compact — around 5 to 15 meaningful segments — avoids overlapping discount logic and keeps administration clear.
How do I search for a group?
The Player Groups section includes a name search that activates after 2 characters. It matches on substrings, so you only need to type part of the group name.
What is the Description field for?
An optional free-text field for internal notes — for example, the criteria for inclusion or the history of the segment. It is visible only in the CRM and is never shown to the player.
Can I export the list of groups?
Yes. An export button is available in the top-right corner of the Player Groups section. It downloads a spreadsheet with the group name, description, player count, and last-updated date.