UPLOAD

Approved game developers can upload their games using the Developer Portal.

At the top of the upload screen, you'll see three steps:

Game Info - this is where you add information about your game
Upload - provide the technical information about your game and agree to the Game License and Upload Agreement
Preview - play and update your game prior to publication

Tips on how to complete these sections are below.

Note that developers will automatically receive bug reports for their game by email from players, and are required to respond promptly to those emails and bugs.

Game Info

Game Details

Title - enter the name of your game.
- Avoid trademark or copyright issues - please don't use the name of any existing game that you did not create, the name of any real people, or any IP or brand that you do not have a license for.
- This is player facing.
Game Description - your sales pitch!
- Write a clear, engaging description that explains your game’s core gameplay and why players will enjoy it.
- You can use Markdown to format text here.
- At the end of your game description, you should also include any other required information such as:
  - an age suitability guide for your game (e.g., 13+, 18+);
  - if your game collects data, a link to your privacy policy;
  - additionally, we ask that if you used AI in the creation of your game please include a statement noting that AI has been used, and how it has been used. It helps us - Kongregate and developers - maintain transparency with players. Examples may include:
    - noting that certain assets were generated with AI tools
    - identifying AI-assisted creative workflows
    - describing AI systems used for gameplay features
- This is player facing.
Game Instructions - help players know how to play!
- We suggest you start with which keys are used to move (e.g. arrows for left, right, space bar to jump, etc.)
- Add gameplay goals, win and lose conditions, tips for success.
- This is player facing.
Category - in which section of Kongregate should we put this game?
- Choose a category that best defines the gameplay genre. For example, if you choose 'Shooter', then your game will appear with other shooters, and so players who are looking for shoot-em-ups will find your game.
- Categories include:
  - Action, Adventure & RPG, Idle, Multiplayer, Music & more, Puzzle, Shooter, Sports & racing, Strategy & Defense, Tutorials
- Choose the best fit category for your game
  - Once your game is published, you'll be able to add Game Tags via the Developer Portal, that will help you better define how your game is categorized; with game tags your game will show up in more places on the Kongregate main page, and allow even more players to find your game when they filter by tags
- This is player facing.

Collaborators (optional)

Here you can enter the Kongregate user names of up to three people that worked with you on the the game, one name per line.
- Collaborators will be credited on the game page alongside you, as the developer (they'll receive a message allowing them to accept or decline).
- Collaborators can access preview builds and review the performance metrics for the game, however they cannot upload builds or edit game settings - only you as the developer can do that through the approved developer account.

Testers (optional)

You can add the Kongregate user names of up to 20 people that you would like to have access to the game
- Testers can access pre-publication (preview) builds of your game.
- Testers have limited permissions, and cannot upload builds, edit game settings, or view game performance metrics.

API Settings (optional)

API Callback URL
- This field is used when a game uses Kongregate server APIs that require a callback URL, so that Kongregate can notify the developer’s server when specific events happen in the Kongregate back-end.
- For more details see https://docs.kongregate.com/docs/client-api-introduction

Continue to Upload

With the above information entered, click the button to proceed to Upload.

Game Type

Choose the appropriate technology for your game:
- HTML5/WebGL
- Unity Web Player
- Iframe

The options that follow will vary depending on the technology you choose, above, and may include:

Iframe Settings

Iframe URL
- Type in the iFrame URL
- This URL is used to embed the Iframe instead of uploading a build
Min Width, Min Height (pixels)
- Type the minimum size of the frame
- For Portrait games, the minimum width should be set to no less than 620px.
- The minimum game frame should try to stay under 1100x700px to account for shorter laptop screens. We have a fairly hard line at 1150x750px as the maximum required size if at all possible.
Scale to fit container
- If you check this box, your game will automatically scale to fill the available space while maintaining aspect ratio (determined by the min width and height values you enter)
- If the box is unchecked, max width and height (below) define the upper bounds for scaling
Max Width, Max Height (pixels)
- Type the maximum size of the frame
- If you leave these blank, the game frame will always be the minimum set above. If however you specify maxima, the game's frame will automatically, dynamically size to appropriately match the player's browser window. You can then ensure your game matches the dimensions of the Parent frame in order to take advantage of this resizing.

Game File

Chrome removed support for the Unity browser plugin, as such Unity games will need to be in WebGL/HTML5 format for Chrome users, while the .unity3d file will work fine with other browsers.

To help ensure your Unity game can be played on all browsers, Kongregate supports uploading both WebGL/HTML5 and .unity3d versions of your game. We will then serve the appropriate version to each player based on their browser. Uploading two versions is optional, but you should be primarily supporting the WebGL/HTML5 version going forward to give you the widest support for player web browsers.

If you are uploading only an HTML5 build you will need to use the 'HTML5/WebGL' upload option.

Unity File
- Choose the .unity3d file for all browsers, other than Chrome
- Tap 'Choose File' and select the .unity3d file to upload (max. 1 GB)
WebGL/HTML5 File
- Upload one file named index.html or one zip file containing an index.html at the root level, maximum
- Tap 'Choose File' and select the file to upload (max. 1 GB)
Additional Files
- Option to upload a .zip with supplemental files to your base .html
- Tap 'Choose File' and select the file to upload (max. 1 GB)

Media

Game Icon
- Choose the image that will be this game's icon and displayed on the Kongregate store
  - Choose a design that gets your game noticed! It could be an image, words - or both!
  - Tip: choose a clear, high-quality icon that is visually distinctive and easy to recognize at small sizes. Avoid clutter, misleading imagery, or content that could create trademark or copyright issues, or otherwise violate the Content Standards.
  - Tip: For Game Icon and Screenshots, use this template Download to test and preview your design for all instances and how they crop. Note: The live version applies a CSS blur effect for tags, but in the template preview, it appears as transparency instead.
- Tap 'Choose File' and select the icon file to upload
- The game icon should be at least 500 x 400 pixels in dimension
- Format should be JPG, GIF or PNG
- You can change the icon by uploading a different image
- This is player facing
Screenshots
- To help players get excited about playing your game, include some screenshots
  - Grab screenshots of the most impressive parts of the game, and/or which are the most visually appealing.
  - You may want to consider adding a few words on the image to provide context, but these won't get automatically translated, so use words with care.
- Tap 'Choose File' and select the screenshot file to upload. Repeat this up to 5 times, to add 5 screenshots.
- Screenshots should be at least 600 x 400 pixels in dimension
- Format should be JPG, GIF or PNG
- This is player facing

Game Options

These checkboxes let us know additional information about your game, and we may follow-up with you if needed.

This game is exclusive to Kongregate
- Check this box if the only place players will be able to play your game is on Kongregate.
- Kongregate often give greater visibility to, and have occasional promotions for games that are exclusive.
I would like to access Kongregate's Virtual Goods API
- Check this box if you plan to make use of Kongregate Virtual Goods (the 'Kreds' in-game currency).
  - What is it? The Kreds API allows players to purchase virtual items in your game using Kreds. The API includes both client and server-side components. The client API initiates purchases and can also check the user's inventory, which is useful for single-player game unlocks like map packs and advanced features. For games that have consumable items and currency sales, the server-side API enables the game to "use" (decrement the count of) an item in the player's Kongregate inventory.
  - More details here: https://docs.kongregate.com/docs/concepts-virtual-goods
- To use Kreds in your game, you need to implement the API, and we need to make some changes on our side also - this checkbox let's us know you want to do this before the game is published on Kongregate.

Licensing Agreement

This section contains a scrollable window showing the Game License and Upload Agreement. To upload a game to Kongregate, you have to accept this Agreement. It forms the legal framework for the relationship between a developer and Kongregate. It governs how a game can be distributed on the Kongregate platform and defines, among other things, the license granted by a developer to Kongregate, how revenue share programs work, developer responsibilities, what happens in a dispute between us, and other operational terms.

It is important that you understand what this document says and the obligations you are committing to.

To help, we have provided this plain English summary. However, this is for informational purposes only and does not constitute legal or regulatory advice. If you have questions about how these requirements apply to your game or business, we recommend consulting with a qualified professional advisor before accepting this Agreement and uploading a game.

You can find the full text of the upload agreement here.

When you are ready to move on, check the boxes below the Agreement window:

I accept the agreement above
I verify that I am one of the creators of this game and have the rights to distribute it via Kongregate.com
This game does not contain any third-party ad system
This game does not contain any outside login or microtransaction systems

Statistics API

Any event in your game can be submitted to Kongregate as a score. This allows you to use Kongregate's leaderboards, and if the game qualifies we can use those stats to put achievements on the game. In general, we recommend having 3 - 5 statistics in your game to track. More details here.

Use the 'Add a statistic' button to add a statistic. If you do, it will open a new window to allow you to provide a name for each, with a description and specific criteria for each stat
If you don't have these details now, don't worry - you can add these later

Upload

With all the required information entered above, you can now tap the 'UPLOAD' button.
This moves you onto 'Preview'

Preview

With your game uploaded, your game will appear in the Developer Portal in 'Preview' mode. Your game is not yet published and requires Kongregate review before it can be.

In Preview mode, you should be able to play the game, so should your collaborators and testers. But no-one else at this point.

This is a great time to see how the game works on Kongregate
Play test, tweak, change information or builds

In Preview mode, you have the following options:

Edit - make changes to the Game Information (see Game Info)
Upload new version - replace the current build (see Upload)
API Information - add or change the API details (see Upload)
Submit for Review - when you're ready for Kongregate to review your game, tap this button.
- We'll be notified it is ready and will get back to you. We're a small team and review may take a while, but we won't forget!
- You can still make changes during this time, including uploading newer versions

When our review is complete, you'll receive an email and a message in your Kongregate account inbox. The game will either be approved for publishing, or if not, we'll let you know why, as well as any recommendations to help you get the game approved.

You can now move to step 4 of Kongregate's Easy 7 steps to publish your game