# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.
