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

Publish your game to itch.io

What is itch.io?

itch.io is an open marketplace for independent digital creators with a focus on independent video games. It’s a platform that enables anyone to sell/share the content they've created.

Creators have access to detailed analytics and about how people discover, download, or play what they've created.


Why itch.io?

  • It is completely free
  • Easy to prepare the content for upload
  • Easy to update the uploaded files
  • A Devlog can be shared
  • We can set up a Community Forum or Allow Comments only or none
  • No quality requirements, anything can be shared
  • SEO friendly, anything you upload can be easily found in Search Engines.
  • We can share downloadable games for Windows, Linux, Mac, Android and also HTML5 games played in the browser.
  • We can make money without starting our own business and pay taxes. itch.io can collect the money, deal with refund requests and pay the required taxes on your behalf and you can request a payout any time.
  • We can set a fixed price for your content, share it freely or accept a donation
  • Revenue share is also flexible which makes itch.io the most unique, you can decide how much revenue share you want to pay to itch.io and yes you can set this value to 0 if you want and pay nothing yet itch.io still happy to host your content for free and hope if you are successful you are going to consider to pay something to them.
  • No annoying Ads on Browser games

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 or as a standalone executable file. 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.

Creating a Zip Archive of your Export

First let prepare our game for upload, in case of itch.io it is really simple, the only thing you need to do is get the folder containing your game and archive it into a ZIP file. Make sure the index.html file is in the root folder and not in a sub-folder inside. The folder we used to export our game into from GDevelop should be fine.

To archive your game folder, you are going to need an archiving tool. The one I'm using is called 7-Zip I have been using 7-Zip for ages, to be honest I can't even remember using anything else so this is what I recommend. After downloading and installing it, just right click on the folder containing your game and we should have 7-Zip in your list with the option to add to the archive.

After selecting the add to archive option, there are many different options we can tweak, but the only one we are interested in right now is the OK button on the bottom. This will create our ZIP archive, ready to upload to itch.io

If you don't have the quick option in your list, you can launch 7-Zip manually, browse the folder you want to archive, select it and then click the Add button on the top It will bring up the same window as the quick option where you need to press OK.

Uploading your project to itch.io

Next, you need to create an account at itch.io that I won't explain in detail as the steps should be no different from other places you have registered before.

Once you have an itch.io account, you want to login and you want to go to your Dashboard. Here you should find a Create new project button

After clicking the button, you can setup your project, I go through only the most important options required to share your game.

  • Title: this is the title of your game
  • Project URL: this is the URL where your game can be found at itch.io, it normally takes the form of yourname.itch.io/your-game-title. The game title in the URL can be anything, it is up to you what you going to choose but it must be unique, can not be the same as other game titles in your library.
  • Classification: here you can choose what kind of content you want to upload, a game or a book maybe. we obviously want to select game here
  • Kind of project: here you can select what kind of project you want to upload, is it downloadable or a HTML or Flash game, in this case we want to choose the HTML. Later you can add downloadable files that can be purchased or downloaded for free
  • Pricing: this is where you can set if your game needs to be purchased or you accept a donation or you don't want any payment. If you do want payment, you can set how much your game cost or how much donation you recommend
  • Uploads: this is the section where you can actually upload your project and you want to click on the Upload files button

Once you clicked the button, you want to browse and select the ZIP file we have created earlier and it is going to be uploaded to itch.io. Once the upload is done, you can choose from several options

You can choose if the file you have just uploaded is an executable, a book, source code or a mod. You can also set a platform, the price for each file you upload if you want, but the most important option for us “This file will be played in the browser”. By ticking the box we mark our file to be played in the browser.

Finally, you want to click on the save and view page button

After it should load a preview of the page of our game and if we did it right, our browser game should start playing.

Sharing your Project

Now the only thing left to do, we need to set our project to be public so anyone can play it. In order to do that, click on the Edit game button on the top or go back to the Dashboard where our game should be listed now and click Edit in the list.

It will take us back to the project creation page with the option available on the bottom to set our project to be public

Select the public option and click the Save button.

Now anyone should be able to find and play your browser game on itch.io. We can also share a link to the game and even embed the game in to your website if you have one.