As of late 2021, we are in the process of updating Stencylpedia and fixing up outdated & broken content. Thanks for your patience!







Publishing a Flash Game

by Jon (Updated on 2015-10-17)


  • 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. Pick a directory where you have write access.

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 and automatically upload it to our site. If you've already published this game in the past, it will update the existing entry.

Note: There is an 8 MB limit on games published to our Arcade. If your game is larger, publish to a 3rd party sites like and Game Jolt.

How to Remove the Splash Screen

Every Flash game published with Stencyl displays a small badge in the loading screen.

If you'd like to remove this branding (because a sponsor requires it, for example), purchase a license, which includes many 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.,

    site lock

Reducing File Size

Games delivered over the web, even in today's age of widespread broadband internet, are better smaller rather 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.

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.

Still stuck? Ask for help on the forums.

Describe the problem and attach your logs on the forums.

Print Article Edit Article How to Edit an Article
Disclaimer: 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!


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 9 years, 10 months 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 9 years, 10 months ago
The same .swf goes blank screen..administrator, please help us.thanks

1 9 years, 10 months ago
when exporting to swf. it just plays back a black screen? Any help appreciated thanks!
1 10 years, 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 10 years, 3 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 10 years, 7 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 11 years, 9 months ago
How do I remove the site locking?
0 12 years, 1 week ago
This article is informative, but having the solution to the Stencyl Arcade failing to update would be good to include, and also reduce possible redundant forum posts. Could someone please add this, or explain a little bit more?
0 12 years, 4 weeks ago

Sign In to Comment