Operator guideENplayerslistfilterscsv

Players / List

Main player search and monitoring surface with shared table/grid rendering, KYC quick tabs, affiliate lookup, last-deposit filters, CSV export, and direct navigation into the player workspace.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this page shows

Players / List is the default CRM entrypoint for finding a player and moving into the detailed player workspace.

It combines:

  • shared PlayersTable filter controls
  • quick KYC tabs for player mode only
  • table and grid-card result views
  • CSV export of the current result set
  • direct navigation into /player/[playerId]

When to use it

Use this page when you need to:

  • find a player by email, internal ID, or marketing tracking identifiers
  • narrow the list by KYC status, country, tags, registration window, or last-deposit timing
  • export the current player slice for offline review
  • open the full player workspace for one user

How to read it

The page has three practical layers:

  1. Filter panel for search, affiliate lookup, KYC, country, tags, date window, and last-deposit logic.
  2. Quick KYC tabs for All Players, Pending KYC, Verified, and Rejected.
  3. Result view in either table mode or grid-card mode.

The primary navigation field is the Email column. For player rows it opens /player/[playerId].

Filters that change the result

  • Search player
  • Search ClickID or PID
  • Status
  • Country
  • Include tags
  • Exclude tags
  • Date start
  • Date end
  • Last Deposit Date
  • Deposit from
  • Deposit to

Actions operators use most

  • Apply Filters
  • Refresh
  • Export Players CSV
  • Switch between table and grid view
  • Open Player Workspace

Known caveats

  • The page header currently renders a Create Player button, but this page does not route it to a verified create-player flow.
  • Status in the filter row maps to kycStatus; the row badge Status is a separate active/inactive account flag rendered from isActive.
  • The affiliate search box is labelled Search ClickID or PID; in backend it uses a dedicated SQL path instead of the standard db.User.findAndCountAll branch.
  • The Last Deposit Date selector changes the query semantics. Never deposited removes the date inputs and filters for players without a qualifying deposit.
  • When plain text Search player is non-empty, the FE hook resets startDate to 2022-01-01 before requesting data.
  • Lead import and lead-only edit restrictions belong to /players/leads, not to this page.

Verification status

  • status: verified_backend
  • last verified: 2026-04-18
  • note: FE page, shared PlayersTable, usePlayers hook, and UserController.getUsers / GetUsersService filter branches are traced.
Grid columns

Columns

field

Id

Internal user ID shown as the first column.

Visual Type
grid-column
field

Email

Main navigation field for opening the player workspace.

Visual Type
grid-column
field

Name

Human-readable player name shown with avatar initials.

Visual Type
grid-column
field

Status

Active/inactive account badge on the list page.

Visual Type
badge
field

Balance

Current wallet balance formatted with the wallet currency code.

Visual Type
amount
field

Currency Code

Wallet currency displayed on the list page.

Visual Type
chip
field

KYC Status

Verification badge separate from the active/inactive account status.

Visual Type
badge
field

Country

Player country code shown in the list.

Visual Type
text
field

Tags

Visible segmentation tags attached to the player.

Visual Type
chips
field

Edit Player

Opens the player workspace from the final action column or the grid-card footer.

Visual Type
action
Filter dictionary

Filters

field

Search player

Free-text player search, typically by email, user ID, first name, or nickname.

Type
text
Affects
list_results
field

Search ClickID or PID

Narrows the list by affiliate or marketing tracking identifiers through a dedicated backend SQL branch.

Type
text
Affects
list_results
field

Status

Filters the list by KYC status bucket, not by account active/inactive state.

Type
select
Affects
list_results, quick_tabs
field

Country

Restricts the list to a country code.

Type
select
Affects
list_results
field

Include tags

Requires the player row to include the selected tags.

Type
multi-select
Affects
list_results
field

Exclude tags

Removes players carrying any of the selected tags.

Type
multi-select
Affects
list_results
field

Date start

Lower bound for the main date range filter used on the page.

Type
date
Affects
registration_window
field

Date end

Upper bound for the main date range filter used on the page.

Type
date
Affects
registration_window
field

Last Deposit Date

Switches the last-deposit filter between `Any`, `Between`, `Before`, `After`, and `Never deposited` modes.

Type
select
Affects
list_results
field

Deposit from / Deposit date

Lower or single date bound when a deposit-date operator is selected.

Type
date
Affects
list_results
field

Deposit to

Upper date bound when the deposit-date operator is `between`.

Type
date
Affects
list_results
View modes

View modes

field

Table view

Dense grid view intended for scanning and sorting.

field

Grid view

Card view intended for quicker visual inspection on smaller result sets.

Operational notes

Notes

item

`Players / List` and `Players / Leads` share `PlayersTable`, but player mode renders quick KYC tabs and does not expose lead import.

item

Plain text search in `usePlayers` forces `startDate` to `2022-01-01` before the request is built.

item

Affiliate lookup (`searchAffiliate`) uses a dedicated SQL branch in `GetUsersService` instead of the standard `findAndCountAll` path.

item

CSV export omits `sortDirection` from the download query in the FE hook.

Related references

Related pages

pagePlayers / Banking

Banking tab inside the player workspace with transaction filters, a paginated banking grid, analytics cards, CSV export, and automatic-withdrawal availability.

pagePlayers / Detail Workspace

Main player workbench at `/player/[playerId]` with tabbed sections, player-level actions, and modal-based operator workflows.

pagePlayers / Fraud Detection

Fraud-detection tab inside the player workspace with fraud risk assessment, related fraud reports, IP analysis, and identity-graph filtering.

pagePlayers / Game Report

Per-player game or provider report inside the player workspace, filtered by date option and grouped either by game or by provider.

pagePlayers / Inbox

Inbox tab inside the player workspace for reviewing sent notifications, filtering by read state or notification type, and resending or deleting messages.

pagePlayers / KPI Summary

Grouped player-level KPI snapshot inside the player workspace, covering player info, deposits, withdrawals, casino totals, bonus cost, and predictive metrics.