Game providers

1. What this page is for

The Game providers page serves as the control hub for all game providers and individual games available on the website. Administrators can switch providers on, off, or into maintenance; arrange provider display sequences independently for each category tab in the lobby; configure direct-entry behavior when players press a provider; and open provider details to customize logos, artwork, mascots, wallpapers, and individual games.

[!NOTE] The legacy routes /game/provider-performance and /game/provider-report automatically redirect to Reports > Provider report (/report/provider), where you can review turnover and financial performance per provider.

---

2. Before you start

• Permissions: You must have the 'Providers and games' permission granted by an administrator to view, reorder, or edit provider and game settings.
• What to prepare:
  • Artwork files if you wish to override default provider graphics:
    • Provider Card Image: Recommended 600 × 600 px (square, max 5 MB).
    • Provider Logo: Recommended 600 × 200 px (3:1 ratio, max 5 MB).
    • Character / Mascot: Square with transparent background (max 5 MB).
    • Banner Wallpaper: Recommended 1920 × 600 px (max 5 MB).
    • Custom Game Picture: Recommended 600 × 600 px (max 4 MB).
  • Accepted file formats: PNG, JPG, WEBP, and GIF.

---

3. Screen layout

This section consists of two primary operational views:

View 1: Provider Board Overview & Ordering (/game/providers)

1. Page Header: Displays the title Game providers, description, and breadcrumbs.
2. Category Tabs: Filter and arrange provider orders per lobby tab: All providers, Casino, Slot, Fishing, Lotto, Sport, Table, Arcade, Crash, PVP, and Keno.
3. Status Summary Cards: Four quick-filter metric cards: Providers in the tab, On (green), Under maintenance (yellow), and Off (gray).
4. Search & Filter Bar: Text input for searching provider name or code prefix, with date and staff filters.
5. Provider Table (Provider Board): Lists providers in their live display sequence for the active tab, with step reordering arrows, 3-state status switches, and game management buttons.
6. Closed Above Banner (if present): Lists providers turned off by higher-tier agents or system administrators.

View 2: Provider Details & Game Management (/game/providers/[id])

1. Provider Header: Cover image, display name, prefix code, system state chips, category badges, and 3-state status control.
2. Page Audit: Version number, last editor name, and timestamp.
3. Provider Details Form: Custom display name input, card image, logo, and mascot image uploads.
4. Provider Art Section: Wallpaper and mascot configuration for provider-level or category-specific banners.
5. Provider Game List: Complete table of games under this provider, with search, category filters, bulk status controls, and game cover image overrides.

---

4. Search and filters

Provider Board Filters (/game/providers)

Field / Filter	Type	Choices & Usage	Result
Category Tabs	Tab toggle	Choose: All providers, Casino, Slot, Fishing, etc.	Switches the board to order providers specifically for that tab
Status Cards	Metric cards	Click: Providers in the tab, On, Under maintenance, or Off	Filters the table to providers matching that status
Search Bar	Text input	Type provider name or code prefix (e.g. PG, PP)	Displays providers matching your search keywords
Last changed date	Date range picker	Select From date and To date	Displays providers modified within the date range
Last changed by	User typeahead	Search and select staff member name	Shows providers last modified by that user

Game List Filters (/game/providers/[id])

Field / Filter	Type	Choices & Usage	Result
Game Status Cards	Metric cards	Choose: All games, On, Under maintenance, or Off	Filters game table by status
Game Search	Text input	Type game title or game code	Filters games matching your search keywords
Category Dropdown	Dropdown	Choose: All categories or specific game category	Displays games belonging to the selected category

---

5. Data table

1. Provider Table Columns (Provider Board)

Column	What you see	Meaning	Badge or color
Order	Order number with up/down step arrows	Display sequence of the provider in the active tab	• Position 1 displays first in the lobby • Up and down arrow buttons
Provider	Artwork, display name, code prefix, and category badges	Identity and attributes of the provider	• Uppercase prefix badge (e.g. PG) • System state warning if locked by agent • Category pills showing where it has games
Has games in	List of category tags	All lobby categories where this provider offers games	Muted gray pill badges
Games in this tab	Summary text like 12 / 12 games on	Playable games currently active in this tab	• Green: normal active games • Orange: games under maintenance • Red: zero games on
When a player presses it	Behavior description	What happens when clicked in direct-entry tabs	• "Opens [Game title]" • "Lists the provider's games"
Status	3-state status control	Operational availability of the provider	• On: Green • Under maintenance: Yellow • Off: Gray
Actions	Action buttons	Provider and game management commands	See details below

Provider Row Actions

Button	Icon / Color	What happens when clicked	Condition / Notes
Manage its games	Primary text button	Opens the provider detail and game list page (/game/providers/[id])	Always available
Action menu (⋮)	Three vertical dots	Opens secondary commands menu	-
Move to place…	Number icon (in ⋮ menu)	Opens modal to type a specific destination position number	Other rows adjust automatically
Move to top	Double up chevron (in ⋮ menu)	Instantly moves provider to position 1	-
Move to bottom	Double down chevron (in ⋮ menu)	Instantly moves provider to the end of the tab	-
Set what pressing it does	Game icon (in ⋮ menu)	Configures whether clicking enters a game or opens the game list	Available in direct-entry tabs

---

2. Game Table Columns (Provider Game List)

Column	What you see	Meaning	Badge or color
Checkbox	Selection checkbox	Selects games for bulk status actions	Select-all checkbox in header
Order	Sequence number with up/down arrows	Display order of games within this provider	Shared across all tabs where these games appear
Game	Game cover, title, and game code	Game identity details	• Hit badge (Orange-red) • Demo badge (Sky Blue) • X playing live count
Category	Game category title	Primary category the game belongs to	e.g. Slot, Casino
Times played	Numeric count	Total times players have opened this game	Formatted tabular number
Status	3-state control	Game operational availability	• On (Green) • Under maintenance (Yellow) • Off (Gray)
Actions	Game picture button and menu ⋮	Individual game commands	• Game picture: upload custom cover • Menu ⋮: Move to place…

---

6. Step-by-step instructions

1. Changing provider status (On / Under maintenance / Off)

1. Navigate to Games > Providers from the left sidebar.
2. Locate the desired provider in the table.
3. In the Status column, select your desired state:
   • On (green): The provider and its active games appear in the lobby and are fully playable.
   • Under maintenance (yellow): Marked as under maintenance in the lobby; players cannot open games.
   • Off (gray): The provider and its games leave all lobby pages immediately; active players are safely removed from games. The provider preserves its sequence position.
4. If choosing Under maintenance or Off, a confirmation modal displays the number of affected games. Review the details and click confirm.

2. Ordering providers in each lobby tab

1. Clear all active filters and search terms (ordering arrows require the full list).
2. Click on the Category tab you wish to arrange (e.g. Slot or Casino).
3. In the Order column of the provider:
   • Click the Up or Down arrows to step one place at a time.
   • Or click the action menu ⋮ and select Move to place…, type the new position number, and confirm.
4. The new order is saved and reflected on the lobby immediately.

3. Setting direct entry (When a player presses it)

1. Select a direct-entry category tab (such as Casino or Sport).
2. In the When a player presses it column (or via menu ⋮ > Set what pressing it does).
3. In the dialog, select:
   • Opens chosen game: Clicking the provider enters a chosen game immediately (ideal for single-lobby providers), then search and pick the game.
   • Lists the provider's games: Clicking opens the list of all games for that provider.
4. Click Save.

4. Customizing provider name and artwork

1. In the provider board, click Manage its games on the desired provider row.
2. The provider detail page opens (/game/providers/[id]).
3. Under Provider details:
   • Enter Custom display name (or leave blank to use original provider name).
   • Upload Provider Card Image (recommended 600 × 600 px, max 5 MB).
   • Upload Provider Logo (recommended 600 × 200 px, max 5 MB).
   • Upload Mascot / Character (square transparent PNG/WebP, max 5 MB).
4. Click Save in that section.

5. Managing provider games and custom game artwork

1. On the provider detail page, scroll down to Provider games.
2. Changing game status:
   • Change the 3-state control in any game row (On, Under maintenance, or Off).
   • Or check multiple games and click the bulk action buttons: Turn on chosen, Put chosen under maintenance, or Turn off chosen.
3. Overriding game cover artwork:
   • Click the Game picture button in that game's row.
   • In the modal, click Choose picture to upload a site-specific cover (600 × 600 px, max 4 MB).
   • Or click Revert to provider picture to restore the default artwork.
   • Click Save.

---

7. Form fields and settings

Summary of configuration fields on the provider detail page (/game/providers/[id]):

Setting / Field	Required?	What to enter	Example	Rules & limits
Custom display name	Optional	Provider name displayed across this site's lobby	PG Soft Slot	Up to 60 characters; defaults to original name if blank
Provider image	Optional	Square card artwork for the provider	File upload	600 × 600 px recommended; max 5 MB
Provider logo	Optional	Official logo artwork of the provider	File upload	600 × 200 px (3:1) recommended; max 5 MB
Mascot / Character	Optional	Provider mascot graphic	File upload	Square transparent PNG/WebP; max 5 MB
Wallpaper	Optional	Header banner background artwork	File upload	1920 × 600 px recommended; max 5 MB
Mascot artwork	Optional	Character overlay artwork on header banner	File upload	Square transparent PNG/WebP; max 5 MB
Game cover picture	Optional	Site-specific game cover artwork	File upload	600 × 600 px recommended; max 4 MB (PNG, JPG, WEBP, GIF)

---

8. Popups and dialogs

1. Move To Dialog

• When it appears: Triggered when clicking Move to place… from the provider or game row menu ⋮.
• What you see: Displays current position, total count, and an input field for the new sequence number.
• What to do: Enter the target position number (e.g. 1 or 5) and click Move.
• Result: The item moves to that exact position, and other rows adjust their numbers accordingly.

2. Provider Entry Dialog

• When it appears: Triggered when clicking Set what pressing it does in direct-entry category tabs.
• What you see: Choice between Opens chosen game and Lists the provider's games, with a game search input.
• What to do: Select the desired mode; if choosing a game, search and pick it, then click Save.
• Result: Controls whether players enter directly into a game or browse the game catalogue when clicking this provider.

3. Confirm Modal & Close Impact Dialog

• When it appears: Triggered when switching a provider or games to Under maintenance or Off.
• What you see: Warning summary detailing the impact (e.g. active players will be removed, games will leave search/lobby) and total affected games count.
• What to do: Review the impact carefully and click the red or primary confirmation button.
• Result: Updates the status across all relevant lobby pages immediately.

4. Game Picture Dialog

• When it appears: Triggered when clicking Game picture in any game row.
• What you see: Current cover, toggle between provider default and custom site picture, and file upload button.
• What to do: Upload a new image or click revert to provider picture, then click Save.
• Result: The lobby updates to display the chosen cover artwork specifically for your site.

5. Version Conflict Dialog

• When it appears: Triggered if another administrator reordered providers or updated games while you were working on the page.
• What you see: Warning modal alerting you that server records have changed.
• What to do: Click Load latest to fetch the latest state.
• Result: Protects against overwriting recent team modifications.

---

9. Statuses and badge colors

Status / Badge	Color	Meaning	Next action
On	Green	Provider or game is active and playable	Normal operation
Under maintenance	Yellow	Shown with a maintenance badge; games cannot be launched	Switch to On once maintenance completes
Off	Gray	Completely hidden from lobby, search, and home sections	Switch to On when ready to offer
Closed above	Red / Orange	Switched off by higher-tier agents or system admin	Cannot be enabled locally; wait for agent release
Hit badge	Orange	Game is featured or ranked in a hit section	Automatic badge
Demo badge	Sky Blue	Game supports free trial gameplay without real balance	Automatic badge
X playing	Green / Blue	Live count of players currently in this game	Real-time metric

---

10. Frequently asked questions & troubleshooting

• Why are the order step arrows disabled:
  • Step arrows work only when viewing the full, unfiltered list. Clear search keywords and reset the status filter to "Providers in the tab", or use Move to place… instead.
• What happens to players when a provider is switched off:
  • Any player currently inside a game from that provider is safely exited back to the lobby immediately. To pause access gently without removing existing listings, use Under maintenance instead.
• How to resolve providers marked as "Closed by agent above":
  • These providers have been disabled at the upstream agent level. You cannot turn them on locally, but your custom artwork and sequence positions remain preserved and will reactivate once the upstream agent enables them.
• A provider is turned On, but doesn't appear in the lobby:
  • Verify that at least one game under that provider is set to On. If all games are off, the provider is omitted from the lobby.
  • Verify that the corresponding category tab (e.g. Slot or Casino) is set to Shown in Game tabs.
• Upload fails with file size error:
  • Provider images, logos, and wallpapers must be 5 MB or smaller. Game covers must be 4 MB or smaller. Ensure files are PNG, JPG, WEBP, or GIF.