Operator guideEN

Casino / Collections / Add Games

Relation workflow for assigning, removing, ordering, or bulk-loading games in a collection.

How to use this guide

Start with the main guide

Follow the explanation and examples first. Extra definitions and formulas are available below when you need them.

What this page does

This page is the assignment workspace for one collection. It shows games currently valid for the selected collection on the left and a filtered active casino game list on the right.

The left side is the collection membership list. The right side is not a guaranteed "only unassigned games" list; it is the active casino game list with search, game-code, provider, removed-game, and pagination controls. Adding a row upserts that game as valid for the selected collection.

What operators can do

  • Add a game from the available list into the collection.
  • Remove a game from the current collection set.
  • Drag current games into a new order; the order is saved immediately after drop.
  • Bulk upload games into the collection by pasting one game name per line.
  • Reset collection game order values through the Reset confirmation modal.

Known caveats

  • This page manages game membership and order only; it does not edit the collection record itself.
  • Removing a game marks the mapping as no longer valid rather than deleting history.
  • Reordering the current list saves as soon as a row is dropped, without a separate save button.
  • Current games are read with a fixed page size of 500. If a collection has more than 500 valid games, this page does not prove that every mapping is visible.
  • Reset uses the same order-save flow with an empty order list. It resets order values; it does not delete all games from the collection.
  • Shared modal copy still says category in places, but this route passes the selected collection id.
More details

Definitions and formulas

Open only the section you need. The relevant section opens automatically when you request help for a specific item on screen.

Calculations11 topicsOpen details

Selected collection context

The route id is the actual target collection for membership changes.

Inputs
route collection id, collection list read
Formula
The route collection id is used for current-game reads and all mapping mutations. The heading name is looked up from the loaded collection list.
Caveats
The heading name can be blank when the selected collection is not present in the first loaded collection page.

Current games query

The left list shows valid game mappings currently loaded for the selected collection.

Inputs
selected collection id, fixed current list pagination, order settings
Formula
Current games are read with selected collection id, page 1, limit 500, order field set to order id, and ascending sort.
Caveats
A collection with more than 500 valid games may have mappings that are not visible on this page.

Available games query

The right list is the source for adding games to the collection.

Inputs
available page, rows per page, search text, game code, provider filter, show removed games flag
Formula
Available games are read from the active casino game list with the selected available-side filters. The page sends active=true, name search, exact game code, provider id, removed-game flag, page, and limit.
Caveats
This flow does not send collection id to the available-games read, so the list is not verified to exclude games already assigned to the collection., The removed-games flag has no verified collection-specific effect in this flow.

Provider display label

Provider labels help operators identify which provider a game belongs to before adding or removing it.

Inputs
provider list, game provider id, aggregator name
Formula
Provider text is built by matching each game's provider id to the loaded provider list. Available rows include provider and aggregator in one label when found.
Caveats
If provider lookup is missing, provider text can be absent while game id and name still render.

Add game mapping

Add makes the selected game part of the collection.

Inputs
selected collection id, selected game id
Formula
Add sends selected collection id and a one-item game id array. The add flow verifies the collection and game exist, then upserts the collection-game mapping as valid.
Caveats
Add is an upsert, so adding an already-mapped game revalidates the mapping rather than creating a duplicate row., The page updates local lists optimistically before source refresh.

Remove game mapping

Remove takes the game out of the collection while preserving mapping history.

Inputs
selected collection id, selected game id
Formula
Remove sends selected collection id, selected game id, and remove=true. The remove flow finds the mapping and sets it invalid.
Caveats
If the mapping row does not exist, the remove flow rejects the update., The page updates local current list before source refresh.

Local drag order

Dragging changes the visible order immediately in the browser.

Inputs
current row array, drag source index, drag destination index
Formula
Drag-and-drop copies the current row array, removes the dragged row from the source index, and inserts it at the destination index.

Reorder save

The visible order is persisted immediately after drop.

Inputs
selected collection id, visible current game order
Formula
After a valid drop, the page sends selected collection id and current visible game ids. The order-save flow first parks all collection mappings at order 99999, then writes submitted ids to order 1..n.
Caveats
There is no separate Save Order button., If the save request fails, the browser-side order can differ from persisted order until refresh., Current rows beyond the fixed loaded set are not included in the submitted order.

Bulk upload precheck

Operators can review unmatched names before committing the bulk upload.

Inputs
pasted game names, selected collection id
Formula
Precheck splits pasted text by newline, keeps non-empty lines, and finds exact game-name matches. It returns names that were not found without adding games.

Bulk upload merge

Matching names are added to the collection in bulk.

Inputs
pasted game names, selected collection id
Formula
Continue upload finds exact game-name matches and upserts matching games as valid mappings for the selected collection.
Caveats
This flow does not save explicit order values despite the Upload Order button label., If no matching games are found, the merge flow returns a no-merge result.

Reset order values

Reset clears custom ordering for the collection's game mappings; it does not remove the games from the collection.

Inputs
selected collection id, empty order list
Formula
Reset sends the selected collection id with an empty order list. The order-save flow parks every mapping for that collection at order 99999 and has no submitted ids to rewrite.
Caveats
Reset is not a membership rollback., Reset can affect invalid historical mappings because the order reset targets all mappings for the collection.
Fields34 topicsOpen details

Route collection id

Selected collection id from the Add Games route.

Data Type
integer
Editable
false

Add games to collection: <name>

Page heading showing the selected collection English name when the collection is found in the loaded collection list.

Data Type
ui-heading
Editable
false
Caveats
The title lookup reads the first collection page; the route id still drives relation actions even if the title name is temporarily blank.

Reset

Opens the reset confirmation modal for collection game order values.

Data Type
action-button
Editable
false

Upload Games

Opens the modal for bulk assigning games by pasted game names.

Data Type
action-button
Editable
false

Saving order spinner

Spinner shown while a drag-and-drop order save is in progress.

Data Type
loading-state
Editable
false

Games in collection

Left-side draggable list of games currently valid for the selected collection.

Data Type
relation-grid
Editable
false

Games in collection count

Count of rows currently loaded into the left-side collection game list.

Data Type
integer
Editable
false

Drag handle

Row handle used to move a current collection game to a different visible position.

Data Type
ui-control
Editable
true

ID

Master casino game id for a current collection game.

Data Type
integer
Editable
false

Name

Casino game name in the current collection list.

Data Type
string
Editable
false

Status

Current-list status label rendered as Active by this page.

Data Type
status
Editable
false

Provider

Provider label resolved from the provider list for the current game.

Data Type
relation
Editable
false

Position / Actions

Current visible position plus the remove control for that collection game row.

Data Type
position-action
Editable
true

Remove from collection

Row action that marks the game mapping invalid for the selected collection.

Data Type
row-action
Editable
true

Current games loading

Spinner shown while the current collection games list is loading.

Data Type
loading-state
Editable
false

Available Games

Right-side active casino game list that can be used to add games to the collection.

Data Type
relation-grid
Editable
false
Caveats
This list is not verified to exclude games already assigned to the collection.

Search

Filters available games by name.

Data Type
text-filter
Editable
true
Payload Mapping
search

Game Code

Filters available games by exact identifier/game code.

Data Type
text-filter
Editable
true
Payload Mapping
simpleIdentifier

Provider

Filters available games by casino provider.

Data Type
relation-filter
Editable
true
Payload Mapping
providerId

Show Removed Games

Visible filter sent with the available-games query.

Data Type
boolean-filter
Editable
true
Payload Mapping
showRemovedGames
Caveats
No collection-specific removed-game behavior was verified for this filter because the collection flow does not send sub-category context required by the removed-games branch.

ID

Master casino game id for an available game.

Data Type
integer
Editable
false

Name

Casino game name in the available game list.

Data Type
string
Editable
false

Provider

Provider and aggregator label for the available game.

Data Type
relation-label
Editable
false

Actions

Available-list add control for assigning a game to the selected collection.

Data Type
row-action
Editable
true

Available games page

Available-games page number. Available-list filter changes reset it to page 1.

Data Type
pagination-state
Editable
true

Available games rows per page

Available-games page size, with visible options 15, 20, and 100.

Data Type
pagination-limit
Editable
true

Games Upload

Modal for bulk assigning games from pasted game names.

Data Type
modal
Editable
false

Game names

Newline-separated game names used by the bulk upload precheck and merge steps.

Data Type
multiline-text
Editable
true
Payload Mapping
gameList

Upload Order

Starts the bulk upload precheck for the pasted game list.

Data Type
action-button
Editable
true

Not matching games

Names that the precheck could not match to casino games during the upload precheck.

Data Type
validation-result
Editable
false

Back

Returns from precheck results to the editable upload text area.

Data Type
action-button
Editable
true

Continue Upload New Game / Continue Upload anyway

Runs the bulk assignment merge after precheck.

Data Type
action-button
Editable
true

Reset

Confirmation modal for resetting order values for the selected collection's game mappings.

Data Type
modal
Editable
false

Reset

Confirms the reset operation.

Data Type
action-button
Editable
true
More help

Related pages

Casino / Collections

Operator guide for casino collection catalog maintenance, including list, create or edit, reorder, and add-games relation flow.

Casino / Collections / Form

Create and edit one collection, including translations, image, active state, portrait-preview preference, and manual preview games.

Casino / Collections / List

Searchable collection grid with status filter, page-level summary cards, game counts, image reset maintenance, and row-level collection actions.

Casino / Collections / Reorder

Drag-and-drop ordering screen for casino collections loaded into the reorder table.

Bonuses / Player Bonuses

Related operator ledger for issued bonus instances, including filters, CSV export, and per-user bonus detail.

Casino / Aggregators

Operator overview for the casino-side aggregator registry, pagination, and activation workflow.