Publishing a Flash Game

by Jon (Updated on 2014-01-29)


  • Export to a SWF
  • Publish to our Arcade
  • How to Remove the Splash Screen
  • Site Locking
  • Reducing File Size
  • Troubleshooting


Export to a SWF

A SWF (Shockwave Flash) file is the format for all exported Flash games. This is the file that you upload to portals such as Kongregate and Newgrounds.

  1. To export a SWF, go to Publish > Web > Flash in the main menu.
  2. You'll be asked where to save the game out to.

After a brief wait, your SWF will export. That's it!

Tip: If the game fails to export, consult the troubleshooting section below.


Publish to the Stencyl Arcade

In addition to publishing a SWF, you can publish your game directly to our Arcade to share it with the community and receive useful feedback.

To publish to our Arcade, go to Publish > Stencyl > Arcade in the main menu.

This will generate the SWF behind the scenes and automatically upload it to our site. If you've already published this game in the past, it will update the existing entry by default.

Note: There is an 8 MB limit on games published to our Arcade.


How to Remove the Splash Screen

Every Flash game published with Stencyl has a choice between a badge on the preloader or a pre-game splash screen.

If you'd like to remove this branding (because a sponsor requires it, for example), purchase an Indie or Studio license, which includes other benefits besides splash screen removal.


Site Locking

If your game is popular, people will snatch it and upload it to other sites, causing you to give others ad revenue off your game without your permission.

This can be deterred through site locking, a feature that prevents the game from starting if it's hosted on a different domain from any on a "whitelist" that you create.

1) In the Settings dialog with your game open, click on Loader button on the left sidebar.

Settings Loader Button

2) Fill in the sites that you want the game to work on. If you have multiple, put a comma between them. Do not insert any white space.



Reducing File Size

Games delivered over the web, even in today's age of widespread broadband internet, are better smaller than larger. If your game exceeds 8 MB, you may want to consider cutting it down. The longer the wait, the less likely the game will be played. Here are a couple tips.

1) Reduce the quality of your sounds/music. Switch to Mono (from Stereo) and export at a lesser bitrate. This generates the biggest savings.

2) Ensure that you aren't exporting hi-res graphics. Check that your game's Max Scale for web is 1x (this is under Settings > Web > Maximum Scale).



On occasion, your game will fail to export with no obvious error. Sometimes, it will appear to "hang" at around the 25% mark without throwing an error in the application itself.


Enable the Log Viewer

The first rule when encountering this is to enable the Log Viewer (View > Log Viewer). Retry the export, and you can see if any errors pop up towards the bottom.


In many cases, it's due to an incompatible sound.

If you remove sounds from your game until it successfully exports, you can identify which sound is at fault. Once you do, a safe solution is simply to re-export it from a program such as Audacity while taking heed of the basic requirements of sounds that we talked about in the Sounds article.

  • 44.1 KHz
  • 16-bit
  • Constant bitrate (versus VBR)
  • No metadata


No Write Permissions

A second, less common cause is that the game is able to export to a SWF (you get a file chooser dialog) but fails to write the SWF out to the location you picked. This can be caused by insufficient file permissions. Choose a directory to which you can save files out to.


No matter what the cause is, enabling the Log Viewer and trying to figure out the error on your own (or posting it to the forums) will get you back on track.

Disclaimer: All articles are geared towards Stencyl 3.0 and above. Use comments to provide feedback and point out issues with the article (typo, wrong info, etc.). If you're seeking help for your game, please ask a question on the forums. Thanks!


my thing says that i can not test my games because of an error any help appreciated thanks
0 3 months, 3 weeks ago
I'm not able to publish them to the stencyl arcade? why?
0 4 months, 2 days ago
Can I publish my games to other websites and make money off of them. Whilst using the free version of stencyl

1 4 months, 3 weeks ago
Are there any updates to this problem on how to solve it? I have tried to submit to flash game license and with no success. Please help......
0 8 months, 5 days ago
Crunch Time Prods
I'm having same problem as the others, just getting the stencyl splash screen and then blackness and unresponsive mouse. All preview versions work fine (browser / flash swf)
0 8 months, 2 weeks ago
The same .swf goes blank screen..administrator, please help us.thanks

1 8 months, 3 weeks ago
when exporting to swf. it just plays back a black screen? Any help appreciated thanks!
1 10 months, 1 week ago
Heads Up: We're rewriting this article for 3.0.

Please bring your issues with publication failure to the forums. Article comments are intended to provide feedback on the article or ask for clarification of a point made in the article. If a forum topic ends up being beneficial to the article, we'll include the solution here. Thanks!

2 1 year, 2 months ago
I had remove all the sound, but I still cannot publish my game. May I know how to solve this kind of problem?
0 1 year, 5 months ago
How do i adjust images for smooth resizing. Easy to do in flash, but I don't see a setting in stencyl that allows me to publish to a flash file that has smooth resizing.
0 2 years, 7 months ago

Sign In to Comment