# 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="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FoB5hmrkSkZ1IRnDwepVI%2Fimage.png?alt=media&#x26;token=88a1729e-7b2a-4478-ac27-b809dc986253" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

Set your launcher title and description

<div align="left"><figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2Fa2tmTIxE7wVNnlGlSpeG%2Fimage.png?alt=media&#x26;token=0b530d67-3263-43fb-b744-96c1d6c37cdc" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Customize Appearance**

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

<div align="left"><figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FfaLpfstTovnadN37C3vP%2Fimage.png?alt=media&#x26;token=f1733474-e473-44cf-8815-f6fb487a9f66" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

<figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FjC5aI1z0TCwKAEaUoWKt%2Fimage.png?alt=media&#x26;token=7b84d244-f2de-4bee-ba79-b479f6f6d3a0" alt=""><figcaption></figcaption></figure>

Deploy your launcher build and verify functionality

<figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2F14gB5VK10xBVd85OtPvU%2Fimage.png?alt=media&#x26;token=12acb5ed-1570-4d15-aff8-b4cba1aae01c" 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="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FwOk29AynqJrhVyuWiMlr%2Fimage.png?alt=media&#x26;token=2e309959-d7fa-4cd6-99a2-5f4b8fd2a3da" 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="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2F9RnWz12EmN3CNwfDUzE8%2Fimage.png?alt=media&#x26;token=1d82097f-797f-4720-acc7-9f464d50630f" 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>

***

{% hint style="success" %}

{% endhint %}

***

## 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](https://gamelauncher.cloud/help/applications/create-app)

### 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 %}
