> For the complete documentation index, see [llms.txt](https://gamelauncher.cloud/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gamelauncher.cloud/help/launchers/create-launcher.md).

# Create Launcher

Build a professional game launcher for your application in minutes.

***

## Step-by-Step Guide

**Note:** Since March 31, 2026 the launchers are **automatically created** on account creation.

{% stepper %}
{% step %}
**Create New Launcher**

Click **+ Create Launcher** button

<div align="left"><figure><img src="/files/aHa5TquwtpqVuWZZtO7p" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Configure Basic Info**

Set your launcher title and description

<div align="left"><figure><img src="/files/D7dCgDnjZEOi0wqLzB1Q" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Customize Appearance**

Set branding, colors, and images in the **Customize** tab

<div align="left"><figure><img src="/files/6gGi4z2ehVXSXeLfjhf1" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Deploy & Test**

<figure><img src="/files/oNCpnHsp3k5CB3wEixE2" alt=""><figcaption></figcaption></figure>

Deploy your launcher build and verify functionality

<figure><img src="/files/cqOfpod0OZf49vsR0wxP" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Test & Distribute to Players**

Copy and share your <i class="fa-link">:link:</i> **permanent links** to your users\
(Automatically updated each time you deploy a new launcher update).

**Installer Wizard**

Installs the launcher on the user's system with a setup wizard. Includes automatic shortcuts and uninstaller.

<figure><img src="/files/7yyN2l6Q9UZUc1msxIUr" alt=""><figcaption></figcaption></figure>

**Portable ZIP**

A standalone version that runs without installation. Just extract and run — no admin rights needed.

<div align="center"><figure><img src="/files/DEMwT0cqqf4Xr8UIsNTZ" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

## Launcher Configuration

### Basic Information

<table data-full-width="false"><thead><tr><th width="150">Field</th><th width="100">Required</th><th>Description</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>✅ Yes</td><td>Internal name for management (e.g., "Windows Desktop Launcher")</td></tr><tr><td><strong>Display Name</strong></td><td>✅ Yes</td><td>Name shown to players (e.g., "My Game Launcher")</td></tr><tr><td><strong>Type</strong></td><td>✅ Yes</td><td>Single Launcher (one game) or Multi Launcher (game hub)</td></tr><tr><td><strong>Platform</strong></td><td>✅ Yes</td><td>Windows, macOS, or Linux</td></tr></tbody></table>

***

***

## Image Requirements

When customizing your launcher's appearance, you'll need to upload images that meet specific requirements:

{% hint style="success" %}
**Figma Image Templates:** <https://www.figma.com/community/file/1578217481456529545>
{% endhint %}

<table data-full-width="false"><thead><tr><th width="120">Image Type</th><th width="160">Required Size</th><th width="110">Max Size</th><th width="110">Format</th><th>Notes</th></tr></thead><tbody><tr><td><strong>Icon</strong></td><td>512×512px</td><td>5 MB</td><td>PNG</td><td>Square (1:1 ratio), launcher application icon</td></tr><tr><td><strong>Splash</strong></td><td>960×480px (2:1 ratio)</td><td>5 MB</td><td>PNG/JPG</td><td>Loading screen image, same aspect ratio accepted</td></tr></tbody></table>

{% hint style="info" %}
**💡 Tips for launcher images:**

* **Icon**: Used as the launcher's application icon in Windows/macOS/Linux
* **Splash**: Displayed while launcher is loading, keep it simple and branded
* Use PNG for transparent backgrounds
* Test visibility on both dark and light backgrounds
  {% endhint %}

***

## Linking Apps to Launcher

After creating your launcher, you need to connect it with your applications.

If you need to [create an app click here](/help/applications/create-app.md)

### How to Assign Apps

1. **Navigate to your Launcher**: Go to Dashboard → Launchers → Select your launcher
2. **Open Linked Apps tab**: Click on the "Linked Apps" tab in the launcher page
3. **Add Applications**: Click "+ Add App" button
4. **Select Apps**: Choose which applications to include in this launcher
5. **Configure Order**: Drag and drop to reorder apps (for Multi Launchers)
6. **Save Changes**: Click "Save" to apply the configuration

{% hint style="info" %}
**Single vs Multi Launcher**:

* **Single Launcher**: Can only link one app at a time
* **Multi Launcher**: Can link multiple apps that appear in a game selection menu
  {% endhint %}

{% hint style="warning" %}
**Important**: After linking or unlinking apps, you'll need to rebuild your launcher for changes to take effect.
{% 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gamelauncher.cloud/help/launchers/create-launcher.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.