--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/games/doc/en/concepts/quick-start.md - https://yandex.com/dev/games/doc/hi/concepts/quick-start.md - https://yandex.com/dev/games/doc/ko/concepts/quick-start.md - https://yandex.com/dev/games/doc/ru/concepts/quick-start.md - https://yandex.com/dev/games/doc/tr/concepts/quick-start.md - https://yandex.com/dev/games/doc/vi/concepts/quick-start.md - https://yandex.com/dev/games/doc/zh/concepts/quick-start.md - href: en/concepts/quick-start.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/games/doc/en/llms.txt # Quick start [Yandex Games](https://yandex.com/games/){.external} is a free platform for publishing browser-based games. You connect the SDK, upload your game — and it becomes available to millions of players without installation. We handle hosting, authorization, and monetization — you focus on your game and its growth. Follow the steps below to publish your game on the platform:
```mermaid flowchart LR Game(["🎮 You have
а game"]) --> S1["Create
account"] S1 --> S2["Set up
team
access"] S2 --> S3["Prepare
the game"] S3 --> S4["Upload to
the Console"] S4 --> S5["Pass
moderation"] S5 --> Done(["🚀 Game
published"]) click S1 "en/concepts/quick-start#registration" "Go to step 1" click S2 "en/concepts/quick-start#team-access" "Go to step 2" click S3 "en/concepts/quick-start#requirements-sdk" "Go to step 3" click S4 "en/concepts/quick-start#draft" "Go to step 4" click S5 "en/concepts/quick-start#moderation" "Go to step 5" click Done "en/concepts/quick-start#after-publication" "After publication" classDef start fill:#ffbe5c,stroke:#bd5c0a,stroke-width:2px,color:#000; classDef step1 fill:#ffd27f,stroke:#bd5c0a,stroke-width:1.5px,color:#000; classDef step2 fill:#ffe19f,stroke:#a8a060,stroke-width:1.5px,color:#000; classDef step3 fill:#e8e4a8,stroke:#8a9560,stroke-width:1.5px,color:#000; classDef step4 fill:#b8d8a8,stroke:#5fa070,stroke-width:1.5px,color:#000; classDef step5 fill:#8ec8a4,stroke:#4db09b,stroke-width:1.5px,color:#000; classDef finish fill:#4db09b,stroke:#2d8b5d,stroke-width:2px,color:#fff; class Game start; class S1 step1; class S2 step2; class S3 step3; class S4 step4; class S5 step5; class Done finish; ```
```mermaid flowchart TD Game(["🎮 You have а game"]) --> S1["Create account"] S1 --> S2["Set up team access"] S2 --> S3["Prepare the game"] S3 --> S4["Upload to the Console"] S4 --> S5["Pass moderation"] S5 --> Done(["🚀 Game published"]) click S1 "en/concepts/quick-start#registration" "Go to step 1" click S2 "en/concepts/quick-start#team-access" "Go to step 2" click S3 "en/concepts/quick-start#requirements-sdk" "Go to step 3" click S4 "en/concepts/quick-start#draft" "Go to step 4" click S5 "en/concepts/quick-start#moderation" "Go to step 5" click Done "en/concepts/quick-start#after-publication" "After publication" classDef start fill:#ffbe5c,stroke:#bd5c0a,stroke-width:2px,color:#000; classDef step1 fill:#ffd27f,stroke:#bd5c0a,stroke-width:1.5px,color:#000; classDef step2 fill:#ffe19f,stroke:#a8a060,stroke-width:1.5px,color:#000; classDef step3 fill:#e8e4a8,stroke:#8a9560,stroke-width:1.5px,color:#000; classDef step4 fill:#b8d8a8,stroke:#5fa070,stroke-width:1.5px,color:#000; classDef step5 fill:#8ec8a4,stroke:#4db09b,stroke-width:1.5px,color:#000; classDef finish fill:#4db09b,stroke:#2d8b5d,stroke-width:2px,color:#fff; class Game start; class S1 step1; class S2 step2; class S3 step3; class S4 step4; class S5 step5; class Done finish; ```
{% note tip "Already created an account and connected the SDK?" %} Go straight to [filling out the draft](https://yandex.com/dev/games/doc/en/console/add-new-game.md#step-create-and-fill-draft). {% endnote %} ## Step 1. Register {#registration} ### In the Console {#console} The [Developer Console](https://games.yandex.com/console){.external} is your personal dashboard where you manage games: upload builds, configure monetization and promotion, and track metrics. To get access: 1. [Create a developer account](https://yandex.com/dev/games/doc/en/console/manage-account.md). When registering, use a Yandex ID with a Yandex login. 1. In the **Account** section, specify your [Preferred language for communication](https://yandex.com/dev/games/doc/en/console/manage-account.md#profile-manage). This is the language we will use to communicate with you. ### In Yandex Advertising Network {#partner} Yandex Advertising Network is required for [enabling monetization](https://yandex.com/dev/games/doc/en/console/adv-monetization.md#enable-int-monetization) and receiving payments for advertising and in-app purchases: 1. Create an account in [Yandex Advertising Network (YAN)](https://partner.yandex.com/){.external} and accept the terms of the agreement. 1. Provide your [payout details](https://partner.yandex.com/v2/settings/financial/){.external} and current contacts. ## Step 2. Set up team access {#team-access} If you work in a team, configure [roles and permissions](https://yandex.com/dev/games/doc/en/console/teamwork.md) in the [Users and access](https://games.yandex.com/console/linked-accounts){.external} section. Another team member will be able to upload the game on your behalf. ## Step 3. Prepare the game archive {#requirements-sdk} ### Review the requirements {#requirements} Study the [requirements](https://yandex.com/dev/games/doc/en/concepts/requirements.md) for the game and promotional materials — this will save time during moderation. ### Connect the SDK or plugin {#sdk} The SDK unlocks platform features: it helps add advertising and purchases, save player progress on Yandex servers, and change game behavior without updating the build. You cannot publish a game without the SDK. You can connect the SDK: - [directly](https://yandex.com/dev/games/doc/en/sdk/sdk-about.md) through the game code; - using [plugins](https://yandex.com/dev/games/doc/en/sdk.md#official-plugins) for popular game engines. ## Step 4. Upload the game to the Console {#draft} In the Developer Console, [add the game](https://yandex.com/dev/games/doc/en/console/add-new-game.md) and on the **Draft** tab: - upload the archive with game files to the Yandex server; - specify which languages the game is localized into ([recommended languages](https://yandex.com/dev/games/doc/en/concepts/languages-and-domains.md#languages)); - add descriptions and promotional materials. For more information about draft fields, see [Filling out the draft](https://yandex.com/dev/games/doc/en/console/add-new-game/draft.md). If the game has [in-app purchases](https://yandex.com/dev/games/doc/en/console/purchases.md), contact [games-partners@yandex-team.com](mailto:games-partners@yandex-team.com){.external} in advance: specify the game name and ID. ## Step 5. Pass moderation {#moderation} ### Test the game {#test} Before submitting for review, [test the game](https://yandex.com/dev/games/doc/en/console/test-game.md) on your own. {% cut "Common reasons for rejection of publication" %} #| || **Game requirements item** | **Category** | **Violation** | **Explanation** || || [1.6.1.8](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-6-1-8), [1.6.2.7](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-6-2-7) | UI / Interface | Context menu on interaction | A system browser context menu appears on right-click or long press — it must be disabled in the game area. || || [1.6.1.6](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-6-1-6), [1.6.2.5](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-6-2-5) | ^ | System player (desktop and mobile) | Video content is played via the system player instead of the built-in game player — this disrupts interface integrity. [More info](https://yandex.com/dev/games/doc/en/requirements/1/6.md). || || [4.7](https://yandex.com/dev/games/doc/en/concepts/requirements.md#4-7) | ^ | Sound is not paused during ad display | During an ad playback, the game audio continues playing. Audio must be paused for the duration of the ad. || || [1.3](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-3) | ^ | Sound continues when switching tabs | Game music or sounds do not stop when leaving the tab. The game must respond to page focus loss. [More info](https://yandex.com/dev/games/doc/en/requirements/1/3.md). || || [1.19.2](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-19-2) | SDK / Game Ready | Game Ready is not working correctly | Game Ready is connected, but the `ysdk.features.LoadingAPI.ready()` method is called incorrectly or at the wrong moment in the game lifecycle. [More info](https://yandex.com/dev/games/doc/en/requirements/1/19.md#gameready). || || [2.14](https://yandex.com/dev/games/doc/en/concepts/requirements.md#2-14) | ^ | Automatic language detection via SDK is not implemented | The interface language is set manually instead of using `ysdk.environment.i18n.lang`. The game must automatically adapt to the user's language. [More info](https://yandex.com/dev/games/doc/en/requirements/2/14.md). || || [1.19.2](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-19-2) | ^ | Game Ready is not used at all | Game Ready is not integrated, even though it is required for publication in the catalog. [More info](https://yandex.com/dev/games/doc/en/requirements/1/19.md#gameready). || || [1.1](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-1) | ^ | SDK is not embedded or is embedded incorrectly | The SDK script is missing, connected from an unofficial source, or initializes with errors. [More info](https://yandex.com/dev/games/doc/en/sdk/sdk-about.md#check). || || [1.9](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-9) | Technical issues | Progress is not saved | Results, levels, or settings are not saved between sessions. Use the `Player` object to store data. [More info](https://yandex.com/dev/games/doc/en/requirements/1/9.md). || || [1.14](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-14) | ^ | Game does not launch | The loading screen freezes or the game does not reach gameplay. Check the console for initialization errors. [More info](https://yandex.com/dev/games/doc/en/requirements/1/14.md). || || [1.14](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-14) | ^ | Error at startup or during actions | JS errors appear in the browser console at startup or during gameplay that affect functionality. [More info](https://yandex.com/dev/games/doc/en/requirements/1/14.md). || || [1.15](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-15) | ^ | Game freezes or lags | Noticeable freezes or performance drops make the game uncomfortable for the user. [More info](https://yandex.com/dev/games/doc/en/requirements/1/15.md). || || [2.3](https://yandex.com/dev/games/doc/en/concepts/requirements.md#2-3) | Compliance with description | Game does not match the declared genre | The gameplay contradicts the [category](https://yandex.com/dev/games/doc/en/console/add-new-game/draft.md#field-category) selected in the **Draft** tab. The genre and description must accurately reflect the game's content. || |# {% endcut %} ### Submit for moderation {#submit} On the **Draft** tab, click **Submit for moderation** — the game will move to **Waiting for moderation** status. If you want to choose the release time yourself, enable the [Postpone publication](https://yandex.com/dev/games/doc/en/console/add-new-game/draft.md#field-delay) option in advance. The game will be reviewed for compliance with the [requirements](https://yandex.com/dev/games/doc/en/concepts/requirements.md). [Moderation](https://yandex.com/dev/games/doc/en/concepts/moderation.md) usually takes 3–5 working days. {% cut "About moderation results" %} You will see the review results in the [Console](https://games.yandex.com/console){.external}: - If moderation approves the game, the status will change to: - **Published**: the game will be published automatically. - **Verified**, if the **Postpone publication** option is enabled. The **Publish** button will appear on the **Draft** tab. - If publication is rejected, the status will change to **Rejected**. The reasons will be sent to the email specified in the [developer account](https://yandex.com/dev/games/doc/en/console/manage-account.md#profile-manage). {% endcut %} ## After publication {#after-publication} - For one week, the game will be in the [New](https://yandex.com/dev/games/doc/en/concepts/ranking-and-featuring.md#new-category) section, and ML algorithms will determine the right audience for it. - After two weeks, a [rating](https://yandex.com/dev/games/doc/en/concepts/metric.md#product) of player engagement and retention will appear on the game card. Next comes [game operations](https://yandex.com/dev/games/doc/en/liveops.md): metrics, A/B tests, and audience management.