Instant Games

Game Setup

Updated: Mar 3, 2026
Copy for LLM
After creating your Facebook application and adding the Instant Games product, the next step is to configure your game’s settings, upload required artwork assets, and fill in the metadata that players and reviewers will see.
All of these settings are configured on the App Dashboard. Select your app, then navigate to the relevant sections as described below.

Required Artwork Assets

Facebook requires several artwork assets for your game. These assets are used across various surfaces on the platform, including the Gaming Tab, game detail pages, News Feed posts, and promotional placements. Submitting high-quality assets that meet the specifications below is essential for passing review and presenting your game well to players.

Asset Specifications

AssetDimensionsFormatRequiredNotes
Game Icon
800 x 800 px
PNG or JPG
Yes
Square icon displayed in the Gaming Tab, search results, and game tiles. Must not contain rounded corners (Facebook applies its own rounding).
Cover Image (Landscape)
1200 x 630 px
PNG or JPG
Yes
Used on the game detail page, in News Feed stories, and in sharing previews. Must clearly represent your game.
Cover Image (Square)
1080 x 1080 px
PNG or JPG
Yes
Used in square layout contexts across the platform.
Gameplay Video
1280 x 720 px minimum
MP4
Yes
A short video (15-30 seconds recommended) showing actual gameplay footage. Used on the game detail page and in promotional contexts. Must show real gameplay, not a cinematic trailer.
Banner Image
1200 x 400 px
PNG or JPG
Recommended
Used in some promotional placements and the game detail page header.
Screenshots
Varies (at least 800 px wide)
PNG or JPG
Recommended
Screenshots of actual gameplay. Provide at least 3 screenshots showing different aspects of your game.
Important: All images must be high-resolution and free of compression artifacts. Do not submit blurry, pixelated, or stretched images. Facebook may reject your game during Quality Review if the artwork does not meet quality standards. See Asset Design Guidelines for detailed do’s and don’ts.

Uploading Artwork Assets

To upload your artwork:
  1. Go to your app on the App Dashboard.
  2. In the left sidebar, navigate to Instant Games > Settings (or the equivalent section for game assets).
  3. Upload each required asset in the designated fields.
  4. Click Save Changes after uploading all assets.
Make sure each asset is uploaded to the correct field. Submitting a landscape image in the square image slot (or vice versa) will result in display issues and may cause your game to be rejected during review.

Game Details

Display Name

The display name is the name players see when they discover and play your game. It appears in the Gaming Tab, search results, game detail pages, and News Feed stories.
Guidelines:
  • Keep it concise (1-3 words is ideal for mobile display).
  • Make it memorable and reflective of your game’s theme.
  • Do not include “Facebook,” “FB,” “Meta,” or other trademarked terms.
  • Avoid special characters or excessive capitalization.
  • The name must be unique -- Facebook may reject names that are too similar to existing games.

Description

Write a clear, engaging description of your game. This text appears on the game detail page and helps players understand what your game is about before they play.
Guidelines:
  • Write 2-4 sentences that describe the core gameplay experience.
  • Highlight what makes your game fun and unique.
  • Mention key features such as multiplayer, leaderboards, or tournaments.
  • Do not include links, promotional codes, or references to other platforms.
  • Write in the language that matches your primary target audience.

Category

Select the category that best describes your game. Accurate categorization helps players discover your game through browsing and search. Common categories include:
  • Puzzle
  • Action
  • Arcade
  • Strategy
  • Card
  • Board
  • Sports
  • Trivia
  • Word
  • Simulation
  • Role Playing
Choose the single most accurate category. If your game spans multiple genres, pick the one that best describes the primary gameplay experience.

Keywords

Add keywords that describe your game. Keywords improve discoverability when players search for games on the platform. Choose words that accurately describe your game’s genre, theme, and mechanics.
Tips:
  • Include the genre (e.g., “puzzle,” “match-3,” “racing”).
  • Include theme-related words (e.g., “space,” “medieval,” “cooking”).
  • Include mechanic-related words (e.g., “solitaire,” “trivia,” “building”).
  • Do not include competitor game names, misleading terms, or spam keywords.

Configuring Instant Games Product Settings

Navigate to Instant Games > Settings in the left sidebar of your App Dashboard. This section contains configuration options specific to how your game runs on the Instant Games platform.

Game Platform Support

Indicate which platforms your game supports:
  • Facebook App (iOS) — The game runs within the Facebook app on iPhone and iPad.
  • Facebook App (Android) — The game runs within the Facebook app on Android devices.
  • Web (facebook.com) — The game runs in a web browser on desktop or mobile web.
Most games should support all three platforms. If your game has platform-specific limitations (for example, it requires hardware features only available on certain devices), you can deselect platforms accordingly. However, supporting all platforms maximizes your potential audience.

Orientation

Select the orientation your game supports:
  • Portrait — The game runs in vertical (portrait) orientation.
  • Landscape — The game runs in horizontal (landscape) orientation.
  • Both — The game supports both orientations and adapts dynamically.
Choose the orientation that provides the best gameplay experience. Most casual games use portrait orientation because players typically hold their phones vertically. Games with wider viewports (such as strategy or simulation games) may benefit from landscape orientation.

Data Deletion Callback URL

Facebook requires all apps to provide a mechanism for users to request deletion of their data, in compliance with privacy regulations such as GDPR and CCPA.

What Is the Data Deletion Callback?

When a player removes your game from their Facebook account, Facebook sends a request to your Data Deletion Callback URL notifying you to delete any data you have stored for that player.

How to Set It Up

  1. Go to Settings > Basic in the left sidebar of your App Dashboard.
  2. Scroll down to find the Data Deletion section.
  3. Select Data Deletion Callback URL and enter the URL of an endpoint on your server that handles data deletion requests.
  4. Alternatively, if you do not store any user data on your own servers, select Data Deletion Instructions URL and provide a URL to a page that explains to users that no data is stored.

Implementing the Callback

If you operate a backend server and store player data, your data deletion endpoint should:
  1. Receive the signed request from Facebook.
  2. Parse and validate the signed request using your app secret.
  3. Delete all stored data associated with the player’s user ID.
  4. Return a JSON response with a confirmation URL and a confirmation code.
If your game uses only the Instant Games cloud storage (via the FBInstant.player.setDataAsync API) and does not store data on your own servers, you may use the Data Deletion Instructions URL option instead.

Configuring App Domains

If your game communicates with your own backend server (for example, for multiplayer functionality, leaderboards, or analytics), you need to configure your app domains:
  1. Go to Settings > Basic in the left sidebar.
  2. Find the App Domains field.
  3. Enter the domain(s) of any servers your game communicates with (e.g., api.yourgame.com).
  4. Click Save Changes.
This is required for Facebook to allow communication between the game client (hosted by Facebook) and your backend server.

Privacy Policy URL

A privacy policy URL is required for all Facebook applications, including Instant Games. This must be a publicly accessible web page that describes:
  • What data your game collects from players.
  • How that data is used, stored, and protected.
  • How players can request deletion of their data.
  • Any third parties with whom data is shared.

How to Set It

  1. Go to Settings > Basic in the left sidebar.
  2. Find the Privacy Policy URL field.
  3. Enter the full URL of your privacy policy page (e.g., https://yourgame.com/privacy).
  4. Click Save Changes.
Important: The privacy policy page must be live and accessible at the URL you provide. Facebook reviewers will check this during App Review. If the page is not accessible or does not contain a substantive privacy policy, your app will be rejected.
If you do not have a privacy policy, you must create one before submitting for review. There are free privacy policy generators available online, but make sure the generated policy accurately reflects your game’s data practices.
While not strictly required, providing a Terms of Service URL is strongly recommended. This page should describe the terms under which players use your game.
Set it in Settings > Basic alongside the Privacy Policy URL.

Localization

If your game supports multiple languages, you can configure localized versions of your game name, description, and other metadata:
  1. Navigate to Instant Games > Settings.
  2. Look for the Localization section.
  3. Add translations for each supported language.
Localization significantly improves your game’s appeal in non-English-speaking markets and can increase organic installs.

Setup Checklist

Before proceeding to upload your game bundle, confirm that you have completed the following:
  • Game icon uploaded (800 x 800 px, PNG or JPG)
  • Landscape cover image uploaded (1200 x 630 px, PNG or JPG)
  • Square cover image uploaded (1080 x 1080 px, PNG or JPG)
  • Gameplay video uploaded (MP4, showing real gameplay)
  • Display name set
  • Description written
  • Category selected
  • Keywords added
  • Platform support configured (iOS, Android, Web)
  • Orientation set
  • Data Deletion Callback URL or Instructions URL configured
  • Privacy Policy URL set and accessible
  • App Domains configured (if using a backend server)

Next Steps

Once your game’s settings and assets are fully configured, proceed to:
  1. Upload Bundle — Upload your game’s code and assets to Facebook.
  2. Reviews — Understand and prepare for the review process.