🤑 Indie game store🙌 Free games😂 Fun games😨 Horror games
👷 Game development🎨 Assets📚 Comics
🎉 Sales🎁 Bundles

How to use Butler for HTML games?

A topic by Multiplex Games created Nov 19, 2016 Views: 272 Replies: 8
Viewing posts 1 to 2

I have an HTML game that's around 50MB. It takes a while to upload the whole zip files when updating the game so I installed butler.

However I didn't really understand how does it work for HTML games. Is butler only good for downloadable games ?

Uh nevermind, it's already there in the butler manual, albeit a little bit obscure

Tagging a channel as 'HTML5 / Playable in browser' needs to be done from the itch.io Edit game page, once the first build is pushed. The page also needs to be set to 'HTML' rather than the default 'Downloadable'.


Hey, glad you found the relevant docs section :) Do you have any pointers on how to make it less obscure? We certainly want people to find out how to do it easily!

(Edited 2 times)

Actually yes :)

On this page https://itch.io/docs/butler/pushing.html

Just under "Channel names" headline, another headline "HTML / Playable in browser Games" should do the trick. Also adding this headline to the contents column on the left, under "Pushing builds" could make it even more visible.


Done! Changes will propagate in a bit, since the docs are cached by our servers.

Wow! I'm totally impressed with the reaction speed 8D

Sorry, I still don't get it. How do I push a patch for html5 game if there's no channel? butler won't do that.


So, you always have to specify a channel when pushing with butler, like so:

butler push folder user/game:channel

If your game was previously uploaded via the website, you'll just need to upload it once with butler with a channel name of your choice (that contains 'html5'), delete the old one, and mark the new one as "This file will be played in the browser", and you're all good to go!

The next time you want to upload an upgrade, use the same channel name you just created, and it will update the embed, and distribute patches to itch.io app users. Hope that clarifies things!


Yes, thanks you, that makes a lot of sense.