Game Setup

This section will walk you through configuring the your application and providing artwork for your game. Please note that all artwork described below is mandatory.

Setting up your application

Even if you already have a web game hosted on, or a mobile game on a mobile application storefront, you'll need to create a new app for your Instant Game. You cannot have an Instant Game running on the same Facebook App ID as any other app.

Set Category to "Games"

Go to the Basic Settings section of your app and make sure to set the category to Games. Save your changes.

Add Administrators, Developers and Testers to the App

As Facebook gradually rolls out Instant Games to a wider audience, your game may not be accessible to everyone. To ensure access for all of your developers and testers, add them as Administrators, Developers, or Testers of the Application in the Roles tab of the App Dashboard (see screenshot below). Learn more about roles.

Enable Instant Games in the App Dashboard

Please Note: Do not add Instant Games to a pre-existing Facebook App configured for iOS, Android or Web. The Facebook App ID created for your Instant Game cannot be used for another platform.

Create new Facebook App

To enable* Instant Games for the app, click the + Add Product button at the bottom of the navigation menu. This will open a list of products available to the app. Find Instant Games on the list and click the Get Started button. This will add an Instant Games section to the menu. Make sure to enable the the Use Instant Games toggle. Save your changes before continuing.

Providing artwork and game information

You can upload all of your game's assets and provide game information in the Instant Games section of the App Dashboard. Please note that all assets are mandatory your game will be rejected if any assets are not provided. Additionally, the game may not display correctly without all of the assets, so we recommend uploading all assets before testing your game.

App Video

You should provide a short - and ideally looped - video showcasing gameplay. We recommend 16:9 or 1:1 aspect ratios. Even if your game is in portrait mode, consider optimizing your video for these aspect ratios because News Feed stories are rendered in a landscape-oriented space. In those cases, consider cropping the gameplay video to a rectangular landscape portion of the screen or adding extra information to fill the sides of the video.

Remember, the video needs to showcase gameplay and should not look like an advertisement.

Splash Image

This image will be shown to players while they wait for the game to load. The image's resolution should be 750x1334.

App Icons

Icons will appear in native dialogs on top of the game before and after each game session. It's important to have both game icons, otherwise the game will be shown with a default application icon.

Cover Image and Banner

Similar to the assets above, the Cover Image and the Banner are pieces of artwork that our platform needs to load in order to display our native dialogs, News Feed posts, and Messenger attachments correctly.

Game Information

We need the following information about your game:

  • Publisher: The name of the company publishing the game
  • Tagline: A short sentence that entices new players to play your game. Do not use a list of comma separated keywords.

Next steps

Now that you know how to setup your application and have provided all necessary assets, check out the sections below: