> For the complete documentation index, see [llms.txt](https://wiki.retrobat.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.retrobat.org/navigation/game-collections.md).

# Game Collections

Collections let you browse your games in other ways than "one system at a time": all your favorites, all 2-player games, all your Mario games…

Collections appear in the [System View](https://wiki.retrobat.org/navigation/system-view-and-game-view.md#system-view), like the systems.

There are three kinds of collections:

<table><thead><tr><th width="134.5">Kind</th><th width="391">Content</th><th>Created by</th></tr></thead><tbody><tr><td><strong>Automatic</strong></td><td>Games selected automatically by RetroBat (favorites, last played, arcade…)</td><td>RetroBat: you just enable the ones you want</td></tr><tr><td><strong>Editable</strong></td><td>The games you add yourself, one by one</td><td>You</td></tr><tr><td><strong>Dynamic</strong></td><td>All games matching filters you define (genre, number of players, year…), updated automatically</td><td>You</td></tr></tbody></table>

All collections are managed in **MAIN MENU** > **GAME COLLECTION SETTINGS**:

Retrobat comes bundled with **AUTOMATIC GAME COLLECTIONS** that you can enable.

You can also create your own game collection, to do this you have 2 options:

* EDITABLE COLLECTION
* DYNAMIC COLLECTION

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FhDg4GXhLjKWOaBWG8BYx%2Fimage.png?alt=media&amp;token=e93555d8-44d0-4586-a567-0ed232f165a4" alt=""><figcaption><p>MAIN MENU</p></figcaption></figure></div>

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FKYkSxScTsCmh4CX24rqL%2Fimage.png?alt=media&amp;token=bebbb557-5fde-469b-93e7-527a08b40b6e" alt=""><figcaption></figcaption></figure></div>

## Automatic collections

In **GAME COLLECTION SETTINGS**, select **AUTOMATIC GAME COLLECTIONS**:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FtyoPJmhXzRtnZFfLoBVb%2Fimage.png?alt=media&amp;token=d337a900-1a91-4b20-b302-527d30486266" alt=""><figcaption></figcaption></figure></div>

Tick the collections you want to display. For example, tick **ARCADE**:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FPzsRfJHnYdwvqq57M9Xv%2Fimage.png?alt=media&amp;token=195ed712-0302-456f-b52a-cd8f5ecee5f2" alt=""><figcaption></figcaption></figure></div>

The **Arcade** collection now appears in the System View, with the games of all arcade systems:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FxDeDqANdYix0zz7eJcft%2Fimage.png?alt=media&amp;token=9311f498-5f91-4513-9aa4-92093fb387e2" alt=""><figcaption></figcaption></figure></div>

The list contains three groups:

### Standard collections

<table><thead><tr><th width="262.75">Collection</th><th>Content</th></tr></thead><tbody><tr><td><strong>ALL GAMES</strong></td><td>All your games. Also required for the <strong>quick search</strong> and <strong>FIND SIMILAR GAMES…</strong></td></tr><tr><td><strong>LAST PLAYED</strong></td><td>The games you played recently, the most recent first</td></tr><tr><td><strong>FAVORITES</strong></td><td>The games you marked as favorites (see Favorites)</td></tr><tr><td><strong>2 PLAYERS</strong> / <strong>4 PLAYERS</strong></td><td>Games for at least 2 or 4 players</td></tr><tr><td><strong>NEVER PLAYED</strong></td><td>The games you have never launched</td></tr><tr><td><strong>RETROACHIEVEMENTS</strong></td><td>Games with RetroAchievements</td></tr><tr><td><strong>ARCADE</strong></td><td>The games of all arcade systems</td></tr><tr><td><strong>VERTICAL ARCADE</strong></td><td>Arcade games with a vertical screen</td></tr><tr><td><strong>LIGHTGUN GAMES</strong></td><td>Lightgun games</td></tr><tr><td><strong>WHEEL GAMES</strong></td><td>Steering wheel games</td></tr><tr><td><strong>TRACKBALL GAMES</strong></td><td>Trackball games</td></tr><tr><td><strong>SPINNER GAMES</strong></td><td>Spinner games</td></tr></tbody></table>

### Per genre

One collection per game genre (action, platform, racing, shoot'em up…).

### Arcade systems

One collection per arcade system (CPS-1, CPS-2, Neo Geo, Naomi…). Only the arcade systems for which you have games are listed.

{% hint style="info" %}
Most automatic collections use the **game information**: number of players, genre, arcade system… Scrape your games first so that these collections are complete (see [Scraping & Metadata](https://wiki.retrobat.org/navigation/scraping-and-metadata)).
{% endhint %}

### Favorites

For the FAVORITE collection, you need to flage your favorite games, this can be done in the **Game Options** menu.

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FpJEpDob9nzhBTXXY61Pd%2Fimage.png?alt=media&amp;token=efd5230b-e9e9-4f51-a14c-c5260bc19e2a" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Shortcut: in the Game View, hold **North** ![](https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FGZFikV2tJe65SRVykNh6%2Fimage.png?alt=media\&token=4361cf61-b659-4a69-bf15-f6473f492730) on a game to add it to (or remove it from) your favorites.
{% endhint %}

You can also display favorite games at the top of the game lists: press **SELECT** ([View Options](https://wiki.retrobat.org/navigation/view-options.md)) > **VIEW CUSTOMIZATION**:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FwY4DDCsL0o7FebehqDaH%2Fimage.png?alt=media&amp;token=8261aca0-e9f3-4c38-ac36-8cab36790cba" alt=""><figcaption></figcaption></figure></div>

Then enable **SHOW FAVORITES ON TOP** in the **GAMELIST OPTIONS**:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2Fj1eqeftsB1iO1ImwL5nF%2Fimage.png?alt=media&amp;token=10137863-2f63-40b0-bab2-54f1b715d58f" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
To show favorites on top for all systems, enable the same option in **MAIN MENU** > **USER INTERFACE SETTINGS** > **GAMELIST OPTIONS**.
{% endhint %}

## Editable collections

You choose the games of an editable collection one by one.

### Creating an editable collection

1. In **GAME COLLECTION SETTINGS**, select **CREATE NEW EDITABLE COLLECTION**:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FWFOVw0A6WcHOmf2OaHTM%2Fimage.png?alt=media&amp;token=33a60db4-c4ef-49af-a41f-92e5c6739f53" alt=""><figcaption></figcaption></figure></div>

2. Enter a name and validate:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2F8WeYnb75pc89CGLFBtsQ%2Fimage.png?alt=media&amp;token=5011f7ee-9ef2-4ade-b868-876e39a35a46" alt=""><figcaption></figcaption></figure></div>

The collection appears in the System View, alone or in the **COLLECTIONS** folder (see [Where do my collections appear?](#where-do-my-collections-appear)):

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FxVDpTmEPGenCrGkDch9o%2Fimage.png?alt=media&amp;token=79e90bf4-8b82-40b8-b7d8-41abe1a32fbc" alt=""><figcaption><p>New Collections folder</p></figcaption></figure></div>

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FFa5zS7JaBf2Q9DORz4kU%2Fimage.png?alt=media&amp;token=ee301cbe-64e9-41ea-948c-984fbe4d7934" alt=""><figcaption><p>Mario Games collection appears in the Collections folder</p></figcaption></figure></div>

### Adding a game

In the Game View of any system, hold **South** ![](https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FGdT1gsy4N0gpwBMWxYbg%2Fimage.png?alt=media\&token=2192c315-9aad-4a5f-9a01-fc062707924a) on a game to open the [Game Options](https://wiki.retrobat.org/navigation/game-options.md), and choose the collection in the **COLLECTIONS** group (**ADD TO MARIO GAMES**, or **ADD TO CUSTOM COLLECTION…** if you have several collections):

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2F00dVOjDa2UPuAvYuVzyQ%2Fimage.png?alt=media&amp;token=daa4a16b-47a1-4ddb-b59f-bff5c7234d84" alt=""><figcaption></figcaption></figure></div>

The game now appears in the collection:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FPoXBzxnpcxlNmwYIDKQD%2Fimage.png?alt=media&amp;token=e44479e2-a2e5-4d09-8d78-39d15902ddde" alt=""><figcaption></figcaption></figure></div>

### Removing a game

Open the Game Options of the game and choose **REMOVE FROM** followed by the collection name.

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FFucEojO1NDmUiEBszqNM%2Fimage.png?alt=media&amp;token=e1c48c75-04de-4ac3-b248-76f7552fb746" alt=""><figcaption></figcaption></figure></div>

## Dynamic collections

A dynamic collection contains all the games that match the filters you define. It updates automatically: when you add a game that matches the filters, it appears in the collection.

### Creating a dynamic collection

1. In **GAME COLLECTION SETTINGS**, select **CREATE NEW DYNAMIC COLLECTION**:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FzSfuW4lsqKxip0HvB6XE%2Fimage.png?alt=media&amp;token=d5a72049-02b8-4572-8178-031402eccc37" alt=""><figcaption></figcaption></figure></div>

2. Enter a name and validate:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2Fd7pnNlJGSI1ppTNRmgt1%2Fimage.png?alt=media&amp;token=ad8d0362-284f-41f6-88e4-820281e33d91" alt=""><figcaption></figcaption></figure></div>

3. The list of filters is displayed:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FZ6B3ZPoqB3AGI0UCkhAd%2Fimage.png?alt=media&amp;token=7632ac07-27d5-417f-82dd-e9212206632b" alt=""><figcaption></figcaption></figure></div>

4. Select the filters you want (for example **MISSING MEDIAS** to list the games without the media you expect), then go **BACK**:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FbCLox83xVjZUUTHWFPuF%2Fimage.png?alt=media&amp;token=544be819-6099-4a23-8624-d7c7289a5890" alt=""><figcaption></figcaption></figure></div>

The collection is created with the selected filters:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2F9e4nFs3Bj0tCS3Wgyd3J%2Fimage.png?alt=media&amp;token=86ad6808-b099-435b-8be4-ab03f24ba7b8" alt=""><figcaption></figcaption></figure></div>

### Available filters

<table><thead><tr><th width="347.75">Filter</th><th>Keeps the games…</th></tr></thead><tbody><tr><td><strong>FIND GAMES</strong></td><td>whose name contains a text</td></tr><tr><td><strong>SYSTEMS</strong></td><td>of the selected systems</td></tr><tr><td><strong>FAVORITES</strong></td><td>marked (or not) as favorites</td></tr><tr><td><strong>GENRE</strong>, <strong>FAMILY</strong>, <strong>TAG</strong></td><td>of a genre, a game family or with a tag</td></tr><tr><td><strong>PLAYERS</strong></td><td>for a number of players</td></tr><tr><td><strong>PUBLISHER/DEVELOPER</strong>, <strong>YEAR</strong>, <strong>RATING</strong></td><td>from a publisher or developer, a year, with a rating</td></tr><tr><td><strong>REGION</strong>, <strong>LANGUAGE</strong></td><td>of a region or a language</td></tr><tr><td><strong>ALREADY PLAYED</strong></td><td>already played (or never played)</td></tr><tr><td><strong>KIDGAME</strong></td><td>marked as kid games</td></tr><tr><td><strong>HAS ACHIEVEMENTS</strong></td><td>with RetroAchievements</td></tr><tr><td><strong>MISSING MEDIAS</strong>, <strong>HAVING MEDIAS</strong></td><td>without or with media</td></tr><tr><td><strong>LIGHTGUN</strong>, <strong>STEERING WHEEL</strong>, <strong>TRACKBALL</strong>, <strong>SPINNER</strong>, <strong>VERTICAL</strong></td><td>for these controllers, or with a vertical screen</td></tr></tbody></table>

{% hint style="info" %}
**Faster:** in the Game View of a system, apply filters with **SELECT** > **OTHER FILTERS**, then choose **CREATE NEW DYNAMIC COLLECTION** in the same menu: the collection is created with these filters.
{% endhint %}

### Changing the filters

Open the dynamic collection, press **SELECT** and choose **EDIT DYNAMIC COLLECTION FILTERS**.

## Where do my collections appear?

Editable and dynamic collections appear either individually in the System View, or inside a **COLLECTIONS** folder. This is defined by **GAME COLLECTION SETTINGS** > **GROUP CUSTOM COLLECTIONS**:

<table><thead><tr><th width="207.75">Value</th><th>Behavior</th></tr></thead><tbody><tr><td><strong>UNTHEMED</strong> (default)</td><td>Collections that have their own design in the theme appear individually; the others are grouped in <strong>COLLECTIONS</strong></td></tr><tr><td><strong>ALWAYS</strong></td><td>All your collections are grouped in <strong>COLLECTIONS</strong></td></tr><tr><td><strong>NEVER</strong></td><td>All your collections appear individually</td></tr></tbody></table>

{% hint style="info" %}
**CREATE FROM THEME** (in **GAME COLLECTION SETTINGS** > **CREATE CUSTOM COLLECTION**) lists the collection names for which your theme has a design (logo, background…). A collection created this way is displayed with these visuals.
{% endhint %}

## Managing your collections

<table><thead><tr><th width="241.5">I want to…</th><th>How</th></tr></thead><tbody><tr><td>Hide a collection without deleting it</td><td><strong>GAME COLLECTION SETTINGS</strong> > <strong>CUSTOM GAME COLLECTIONS</strong>: untick it</td></tr><tr><td>Delete a collection</td><td>Open the collection, press <strong>SELECT</strong> (or hold <strong>South</strong> on a game) > <strong>DELETE COLLECTION</strong></td></tr><tr><td>Show the system name of each game in collections</td><td><strong>GAME COLLECTION SETTINGS</strong> > <strong>SHOW SYSTEM NAME IN COLLECTIONS</strong></td></tr><tr><td>Show in collections the games of hidden systems</td><td><strong>GAME COLLECTION SETTINGS</strong> > <strong>SHOW GAMES OF HIDDEN SYSTEMS IN COLLECTIONS</strong></td></tr><tr><td>Sort collections with the systems</td><td><strong>GAME COLLECTION SETTINGS</strong> > <strong>SORT CUSTOM COLLECTIONS AND SYSTEMS</strong></td></tr></tbody></table>

{% hint style="info" %}
Your collections are stored in `emulationstation\.emulationstation\collections`:

* editable collections: `custom-<name>.cfg` (one game path per line);
* dynamic collections: `<name>.xcc`.

Back up this folder to keep your collections.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wiki.retrobat.org/navigation/game-collections.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
