How to Upload HTML5 Games to Facebook Developer Dashboard (Complete Guide)

Uploading an HTML5 game to the Facebook Developer Dashboard is the most important step before publishing your game on Facebook Instant Games.

Many beginners feel confused at this stage because the dashboard looks technical at first. But once you understand the flow, it becomes very simple and structured.

In this guide, we will go step by step so you can upload your HTML5 game without missing anything.

Step 1: Login to Facebook Developer Account

First, you need to log in to your Facebook Developer account.

Once logged in:

• Open the Developer Dashboard
• Go to “My Apps” section
• Select or create a new game app

This app will hold your HTML5 game project.

Step 2: Create a New Game App

If you don’t already have an app, create one.

Select:

• App type: Games
• Platform: Instant Games

Then enter:

• App name
• Email
• Basic details

After creation, your app dashboard will open.

Step 3: Enable Instant Games Product

Inside your app dashboard, you need to add the Instant Games product.

This step activates game publishing features.

After enabling it, you will get:

• Game settings panel
• SDK setup tools
• Upload and testing options

This is where your HTML5 game will be connected.

Step 4: Prepare Your HTML5 Game Build

Before uploading, your game must be properly ready.

Make sure:

• index.html file works correctly
• Game loads fast in browser
• Mobile controls are working
• No major bugs exist
• Assets are optimized

Facebook only accepts stable and lightweight HTML5 games.

Step 5: Upload Game Files to Dashboard

Now go to the Instant Games section and upload your files.

You will typically upload:

• HTML files
• JavaScript files
• CSS files
• Asset folders (images/audio)

Make sure the main entry file is correctly set as index.html.

If the structure is wrong, the game will not run properly.

Step 6: Configure Game Settings

After uploading, you need to configure settings like:

• Game name
• Description
• Category
• Age rating
• Icon and thumbnail

These details help Facebook understand your game better.

A clean setup improves approval chances.

Step 7: Integrate Facebook Instant Games SDK

Next, you need to connect your game with Facebook SDK.

This helps your game:

• Track player sessions
• Save progress
• Handle events
• Connect with Facebook system features

Without SDK integration, many features will not work properly.

Step 8: Test Your Game in Dashboard

Before publishing, testing is very important.

Use the test mode to check:

• Game loading speed
• Mobile compatibility
• Controls response
• Performance issues
• Bug detection

Testing ensures your game works properly for real users.

Step 9: Submit for Review

Once everything is ready, submit your game for review.

Facebook checks:

• Game performance
• Policy compliance
• Stability
• User experience

If everything is correct, your game will be approved for publishing.

Step 10: Publish Your Game

After approval, your HTML5 game becomes live on Facebook Instant Games.

Now users can:

• Play instantly
• Share with friends
• Discover your game on platform

Publishing is only the beginning of your game journey.

Final Thoughts

Uploading HTML5 games to Facebook Developer Dashboard is a structured process.

If you follow each step carefully:

• Create app
• Enable Instant Games
• Upload files
• Add SDK
• Test properly
• Submit for review

Then your game can successfully go live on the platform.

The most important thing is keeping your game simple, fast, and optimized for mobile users

FAQs

1. What is Facebook Developer Dashboard used for?

It is used to create, manage, upload, and publish games for Facebook Instant Games platform.

2. Can I upload HTML5 games directly?

Yes, Facebook supports HTML5-based games through the Instant Games system.

3. Is SDK required for all games?

Yes, SDK integration is important for features like tracking and game events.

4. What is the main file for HTML5 games?

The main entry file is usually index.html, which loads the game.

5. How long does Facebook review take?

Review time depends on game quality, but it usually takes a few days.