**This is an old revision of the document!**

Publishing your Game to Kongregate

What is Kongregate?

Kongregate is a mobile, PC, and Console publisher and web gaming portal. The website features over 110,000 online games and 30+ mobile games available to the public. On the web portal, users can upload HTML 5/JavaScript, Shockwave, Java or Unity games. It is a great home for your game and can connect you with a thriving community of active and engaged gamers!

Kongregate FAQ

  • Who can submit a game?

Games can only be uploaded by their legal owner and all uploaders must agree to Kongregate's Game License Uploading terms.

  • Earn money without giving up the farm

Kongregate shares up to 50% of advertising revenue with developers and sponsors monthly contests where you can earn thousands more. You retain the full rights to your game by uploading it onto Kongregate and you may request that it be removed at any time.

  • APIs improved experience & payouts

API integration enables your players to appear on our leaderboards, earn badges and enjoy card challenges.

You can know more about Kongregate here

Building the Package

First off, if you haven't built the package yet, let's go through the steps to make your game ready to be published and playable in a browser. Click the icon shown on the left. It is at the top-left corner of your screen.

A dialog box appears, where you can choose the platform for which the game is to be built. For this tutorial we are focusing on a HTML5 build where the game can be played in the browser itself. Scroll down to Advanced and choose the Local Folder option.

Make a new folder anywhere in your computer. For example, I have already created a folder named Endless Runner in my Desktop. Click Choose Folder and direct it to the folder we just created.

Making the Package Ready to Publish

Our aim is to make the game playable in the web browser in the form of a HTML5 game. In order to upload the files to the web, we must archive it in a .zip file. Firstly, open the folder and move the index.html file out of there. We need that file separately. Make sure there is no remaining index.html file inside that folder. Now we need to archive the folder data.

To archive your game folder, you are going to need an archiving tool. There are several free options available. We will be using 7-Zip in this tutorial. Make sure you have downloaded and installed 7Zip using the link given.

Now, to archive the folder contents, select all the files inside the folder and then Right click. We should have 7-Zip in our list with an option to Add to archive. You will see a dialog box where you can tweak many options. For now, only change the Archive Format to zip. Click OK at the bottom to start the archiving process. Soon after the process is finished, you will find a .zip file according to the option chosen, which is one of the files we will be uploading to Kongregate.

To get ready to upload, we need two files. The first file is the index.html file that we had moved out of the folder and the second file is the .zip archive.

Folder contents need to be at the root level of the .zip file and cannot contain index.html file (we moved it outside the folder, remember?)

Uploading the Game

Head over to the Kongregate website and Register yourself if you haven't already. It should be a very easy process. You need to be a registered user for uploading your games on Kongregate.

Kongregate supports three types of game packages: HTML5, Unity Web and iFrame. The archive we just created is an HTML5 package so we are going to go with that option.

After you have done registering yourself, we can now upload and publish our game. To upload a game, head over to Dev section and Click Upload Your Game.

In the game upload page, you'll need to input basic information, like the game title, description, instructions, category, etc.

Below that are a few specialized sections:

  • Collaborators: You can designate up to 3 additional Kongregate usernames to be “collaborators”. These users will have access to the unpublished version of the game, will be able to make free purchases for testing, and will show up in the game details as a collaborator.
  • API Callback URL: If your game is going to be utilizing one of our server APIs that requires a callback URL, this is where you will enter it.
  • Bug Reports: We can add a “report a bug” button next to your game and send them via email to you. If you select this you will have the option to specify the target email address.

On the following page you will first select the type of game upload:

  • Flash/HTML5/WebGL: In these cases you'll upload your files directly to our server and Kongregate will take care of hosting them.
  • Unity Web Player: This is a special case in which we will host a .unity3d file and optionally also a WebGL version for players using NPAPI-disabled browsers. By the end of the 2016 nearly all browsers will be NPAPI-disabled, so we don't recommend this option if you can help it.
  • iFrame: In this case you'll give us a URL to point to and you will be able to host and serve the game files on your own server.

Select the Flash/HTML5/WebGL type since our game is a HTML5 package. Select the I would like to upload additional files for this game option. For the first file, choose the index.html file and for the second, choose the archived .zip file we had created in the previous step.

Below that you'll be able to submit some art, request access to our Virtual Goods Payments API, and confirm a few basic assertions.

Finally, you'll have the option to specify some Statistics(Any event in your game can be submitted to Kongregate as a score) for your game and add some Tags that help users locate your game based on interests. You can learn more about Statistics here. Lets leave it empty for now. Add one or more tags that you find suitable for you game.

After you have filled all the necessary information and have chosen the files to be uploaded, click on Upload as a final step to publish your game.