--- metadata: - name: generator content: Diplodoc Platform v5.66.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: https://yandex.com/dev/games/doc/en/concepts/quick-start.md type: text/markdown title: Markdown version - href: https://yandex.com/dev/games/doc/en/llms.txt?revision=r21993288 rel: describedby --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/games/doc/en/llms.txt?revision=r21993288 # 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
profile"] 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 profile"] 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 a profile 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-draft). {% endnote %} ## Step 1. Register {#registration} 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. Registration has two stages: [creating a profile](#console) and [signing a contract](#partner). ### Create a profile {#console} A profile gives you access to the Console: 1. [Create a developer profile](https://yandex.com/dev/games/doc/en/console/manage-account.md#dev-profile-create). 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. With a profile, you can [add a game](https://yandex.com/dev/games/doc/en/console/add-new-game.md) and fill out its draft. But until a contract is signed, you won't be able to submit the game for moderation. ### Sign a contract {#partner} A contract unlocks moderation and payments. How you sign it depends on your country and form of cooperation: - Russia, legal entity or sole proprietor — sign a contract under the [unified licensing model](https://yandex.com/dev/games/doc/en/payments.md) right in the Console. - Other countries, legal entity — sign a contract under the [unified licensing model](https://yandex.com/dev/games/doc/en/payments.md) right in the Console. - Other cases — [register](https://yandex.com/dev/games/doc/en/console/adv-monetization.md#enable-int-monetization) with the Yandex Advertising Network: 1. Create an account in [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 {#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), check the [conditions for enabling them](https://yandex.com/dev/games/doc/en/sdk/sdk-purchases.md#conditions) in advance — in some cases, you'll need to submit a request to support. ## 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) | Audio or 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). || || [2.14](https://yandex.com/dev/games/doc/en/concepts/requirements.md#2-14) | SDK / Game Ready | 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, although 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. [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#loading). || || [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#errors). || || [1.15](https://yandex.com/dev/games/doc/en/concepts/requirements.md#1-15) | ^ | Game looks unfinished | The game is missing essential elements (texts, textures, controls, icons) or they don't work, or there are traces of development left ("demo", "in development", "trial version"). [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. || || [8.2.2](https://yandex.com/dev/games/doc/en/concepts/requirements.md#8-2-2) | Game title | Misleading title | The title contains words that mislead the user about the game's terms: "free", "top", "best", "бесплатно", "бесплатный", etc. || |# {% endcut %} ### Submit for moderation {#submit} You can only submit a game for moderation after signing an agreement — under the [unified licensing model](https://yandex.com/dev/games/doc/en/payments.md) in the Console or in [YAN](https://partner.yandex.com/){.external}. If you don't have an agreement, fill in the [second form](https://partner.yandex.com/v2/settings/financial/){.external} and wait for your offer to be accepted. The document review usually takes three business days. 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 profile](https://yandex.com/dev/games/doc/en/console/manage-account.md#profile-manage). {% endcut %} You can submit no more than two requests to publish new games at a time, and one from an [account without history](https://yandex.com/dev/games/doc/en/concepts/moderation.md#queue-order). To send the next game for moderation, wait for a decision on one of your current requests, or withdraw one of them yourself. This limit does not apply to updates of already published games. ## 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.