Instant Games

Best Practices

Updated: Mar 3, 2026
Copy for LLM
This page consolidates the most important recommendations for building, launching, and growing a successful Instant Game on Facebook. These best practices are drawn from the experiences of top-performing developers, platform data, usability research, and the expertise of the Facebook Games team.

Game Design

Keep It Simple to Start

The most successful Instant Games have a core mechanic that players understand within seconds. Avoid complex tutorials, lengthy narratives, or steep learning curves in the early game. You can introduce complexity gradually as players progress, but the first interaction should be immediately intuitive.
The 5-second test: Ask yourself — would a player know what to do within 5 seconds, without reading anything? The best-performing games teach themselves through play. If you can answer “yes,” your game is well-positioned for strong first-session retention.

Design for Self-Teaching Mechanics

Players who discover your game in a feed, notification, or the Gaming Tab have not committed to learning your game. You have seconds to prove the experience is worth their time. Games that teach through play consistently outperform games that rely on text instructions.
Principles for self-teaching design:
  • Use real-world metaphors. A skiing game where you tilt to dodge trees requires zero explanation. A ball-rolling game where you tilt to navigate a maze is immediately understood. When the game’s premise maps to a real-world experience, the controls and hazards are self-evident.
  • Make hazards visually obvious. Players cannot avoid what they cannot identify. Hazards must differ from targets in color, silhouette, size, or motion pattern — not just in name. Use universally understood threat signals: spikes, red coloring, aggressive movement patterns, warning symbols.
  • Align perspective with gesture direction. When the camera angle and movement direction match the player’s natural gesture orientation (e.g., tilting left to steer left), controls feel invisible. Players focus on the game, not on learning how to play it.
  • Show, don’t tell. If your game requires a specific gesture (tap, swipe, drag, hold), demonstrate it through animation — show both the gesture and its in-game result simultaneously. Text instructions like “swipe to jump” are frequently misinterpreted. An animated hand performing the gesture is far more effective.

Design for Short Sessions

Many players play Instant Games during brief idle moments — waiting in line, between tasks, or during commercial breaks. Ensure that a satisfying gameplay session can be completed in 2-3 minutes. At the same time, support longer sessions for deeply engaged players by offering extended gameplay modes, progression systems, or social competition.

Provide Clear, Immediate Feedback

Every player action should produce clear, immediate feedback. Taps should animate, scores should update visibly, and achievements should be celebrated. Games that feel responsive and rewarding hold attention longer than those that feel sluggish or ambiguous.
This applies to every interactive element in your game:
  • Rule violations: When a player makes a mistake (hitting a hazard, missing a target, running out of time), the consequence must be immediately visible and clearly linked to their action. A subtle life-counter decrement is not enough — use screen flashes, sound effects, character reactions, or other unmistakable signals. If the player doesn’t understand why they failed, they’ll blame your game instead of trying again.
  • Off-screen rules: If your game penalizes players for objects leaving the screen (e.g., missing a falling item), this rule must be explicitly taught. Players will not infer off-screen consequences on their own.
  • Interactive vs. decorative elements: Every visual element must clearly signal whether it is interactive or decorative. Circular, centered, or animated elements carry strong “button” affordance — if something looks tappable, players will tap it. Use a consistent visual language: interactive elements should be bordered, elevated, or highlighted; decorative elements should be flat and muted. When a player taps something decorative and nothing happens, it erodes their confidence in the game’s responsiveness.
  • Meaningful interactions: If your game has a button, tapping it must produce a visible, perceivable effect. Interactive elements with unclear or invisible outcomes feel broken and destroy player agency.

Include a Tutorial

A clear, visual tutorial is both a best practice and a requirement for passing the quality review. Your tutorial should:
  • Demonstrate the core mechanic through guided interaction, not just text.
  • Use animated gesture demonstrations (a hand performing the gesture) rather than text-only instructions.
  • Be completable in under 30 seconds.
  • Be skippable for returning players.
  • Cover essential controls and objectives without overwhelming the player.
For games with precision mechanics (timing, stacking, rhythm), explicitly teach what “success” looks like. If your game rewards precision (e.g., a “perfect” placement in a stacking game), the definition of “perfect” must be visually communicated — through markers, guides, or highlighted target zones. When players don’t understand why they didn’t achieve a perfect score, they feel the game is unfair rather than challenging.
Games submitted without a functional tutorial may be rejected during the quality review process.

Name Elements by Their Effect

Game elements — power-ups, abilities, tools, actions — should be named based on what they mechanically do, not what they thematically are. A turret that slows enemies should be called “Slowdown” rather than “Ice.” A button that triggers a special attack should be clearly labeled, not abbreviated to an obscure acronym.
This matters even more for games with global audiences: action-oriented names translate more clearly across languages. If a name is ambiguous in English, it will be even more confusing in translation.
The same applies to control instructions. If your game requires dragging, say “drag” — not “swipe.” If it requires tapping, say “tap” — not “press.” Test whether your instructions produce the intended physical action. A player who follows instructions correctly but gets the wrong result will blame your game.

Scale Difficulty Fairly

Difficulty should escalate gradually in a way that feels reasonable, fair, and achievable. When difficulty jumps are too steep, players attribute failure to the game rather than their own skill — destroying their motivation to retry.
Best practices for difficulty curves:
  • Gradual ramps: Each difficulty increase should feel like a natural extension of the previous level, not a sudden wall.
  • Perceived fairness: Players need to feel that failure is their fault, not the game’s. Difficulty spikes that feel arbitrary or insurmountable break the re-engagement loop.
  • Learnable failure: Every failure should teach the player something. When a player can’t understand what they did wrong, they won’t come back.
Steep difficulty spikes are a leading cause of Day 1 and Day 7 retention drops. If your game’s retention cliffs correlate with specific levels, examine the difficulty transition at those points.

Design Effective Incentive Loops

Games sustain engagement through compelling incentive loops — earning resources, spending them, and earning more. But the loop only works when spending feels necessary and rewarding.
  • Create spending pressure: Escalating enemy waves, time pressure, score multipliers, or efficiency ratings should make resource deployment feel necessary — not optional.
  • Avoid passive play: If a player can succeed by watching rather than actively engaging, the game isn’t challenging them enough. Design the difficulty curve so active engagement is always the optimal strategy.
  • Balance the economy: Ensure the relationship between earning and spending stays tight enough that spending choices matter throughout the entire game loop. When resources accumulate without purpose, players disengage.

Controls

Match Controls to Player Expectations

Controls are the most intimate part of your game’s design — they determine whether a player feels in command or frustrated. On mobile touchscreens, getting controls right requires deliberate attention.
  • Map to known gestures. Before designing controls, consider which gestures players already know from comparable games. Map your core mechanics to well-known gestures; reserve novel gestures for secondary or optional controls.
  • Calibrate input sensitivity. Overly sensitive controls punish natural player behavior and create a perception of unfairness. Input sensitivity for continuous-control mechanics (steering, tilting, dragging) must be tested with representative players on a range of devices. Consider offering sensitivity settings to accommodate different play styles.
  • Make different controls visually distinct. If your game uses multiple input types (tapping and dragging), their visual controls must look distinctly different. A flat circle reads as a tap button, even if it’s meant to be dragged. Use 3D rendering, shadows, or directional indicators to signal drag/joystick controls. If one side of the screen uses tap buttons and the other uses a joystick, their styling should make the difference self-evident.

Test on Multiple Devices

Instant Games run on a wide range of Android and iOS devices with different screen sizes, touch sensitivities, and performance characteristics. A game that feels perfectly tuned on one device may feel broken on another.
  • Test gesture-based controls on devices with different screen sizes — a swipe that works on a large screen may be too cramped on a 5-inch phone.
  • Test tilt/accelerometer controls on multiple devices, as sensitivity varies between manufacturers.
  • Consider that players with different hand sizes and grip styles may interact with your controls differently.

Technical Performance

Optimize Load Time

Target: Under 3 seconds. Load time is the single most impactful technical metric for an Instant Game. Every second of load time reduces the percentage of players who make it to gameplay.
Strategies to reduce load time:
  • Minimize initial bundle size. Keep your initial bundle under 5 MB when possible. Defer loading non-essential assets until after the game has started.
  • Use progressive loading. Load critical assets first (splash screen, core gameplay assets), then load additional assets in the background during gameplay.
  • Compress assets aggressively. Use texture compression, audio compression (OGG/MP3 rather than WAV), and minified JavaScript.
  • Report loading progress. Use FBInstant.setLoadingProgress() to keep the player informed during loading. A moving progress bar reduces perceived wait time.
See Game Performance for a comprehensive guide.

Optimize Bundle Size

The total bundle size for an Instant Game can be up to 200 MB, but smaller bundles load faster and provide a better player experience. Best practices:
  • Audit your assets. Remove unused images, sounds, and code. Use tools to identify and eliminate dead assets.
  • Choose efficient formats. Use WebP for images, compressed audio formats, and minified/bundled JavaScript.
  • Lazy-load non-critical content. Levels, additional characters, and secondary content can be loaded on demand rather than included in the initial bundle.

Test on Low-End Devices

Instant Games run on a wide range of devices, including older Android phones with limited memory and processing power. Test your game on low-end devices to ensure it performs acceptably. Games that crash or lag on common devices will lose a significant portion of potential players.

Social Integration

Use Social Features Early and Often

Social features are not a nice-to-have — they are a core competitive advantage of the Instant Games platform. Games that integrate social features see measurably higher retention and organic growth.
Priority social features to integrate:
  1. Leaderboards — Show friends’ scores at natural break points (end of round, game over screen). Leaderboards create friendly competition that drives repeat sessions.
  2. Sharing — Let players share notable achievements, high scores, or gameplay moments to their Facebook feed. Each share is a potential acquisition event.
  3. Challenges — Enable players to challenge specific friends. Challenges create direct, personal re-engagement loops.
  4. Tournaments — Create time-limited competitive events that drive concentrated engagement. Tournaments are particularly effective for retention.
See the Retain section for implementation guides for each feature.

Make Sharing Meaningful

Players share content that makes them look good or that they find genuinely entertaining. Design share-worthy moments:
  • Record a player’s best moment, not just their final score.
  • Create visually appealing share images or videos.
  • Include a clear call-to-action that encourages the viewer to play.
  • Personalize shared content with the player’s name or avatar.

Leverage the Social Graph

Use the Instant Games SDK to identify which of a player’s friends also play your game (FBInstant.player.getConnectedPlayersAsync()). Use this information to:
  • Show personalized leaderboards featuring friends.
  • Suggest friends to challenge or invite.
  • Display friends’ progress or achievements within the game.

Monetization

Adopt a Hybrid Model

The most profitable Instant Games combine in-app advertising (IAA) with in-app purchases (IAP). This approach maximizes revenue by serving different player segments — non-paying players generate ad revenue, while engaged players can spend on premium content.

Place Ads at Natural Break Points

  • Rewarded videos: Offer at moments where the player receives clear value — an extra life, a score multiplier, bonus currency, or a hint. Rewarded ads have the highest player acceptance and generate strong eCPMs. Important: The reward must be immediately visible and clearly impactful after the ad completes. If a player watches a 30-second ad and can’t perceive the benefit, they won’t watch another.
  • Interstitial ads: Show between levels, after a game-over, or at other natural transition points. Avoid showing interstitials during active gameplay or too frequently (no more than once every 30 seconds).
  • Banner ads: Display during menus, loading screens, or other non-gameplay moments. Banners generate lower revenue per impression but provide a steady baseline.

Create Clear Incentives for Rewarded Ads

Rewarded video engagement depends on your game creating a clear, compelling reason to watch. The most effective moments are:
  • Near-miss revival: “Watch to continue” after a close loss where the player was emotionally invested.
  • Visible power-ups: Bonuses that have an immediate, dramatic effect on the next round.
  • Time-limited boosts: Multipliers or shields that last for a specific, visible duration.
If your game accumulates resources without creating clear reasons to spend or earn more, both IAP conversion and rewarded video engagement will underperform.

Price IAP Appropriately

  • Offer a range of price points, from small impulse purchases (under $1) to premium bundles.
  • Ensure that purchased items provide clear, visible value.
  • Use limited-time offers and bundles to create urgency.
  • Never force purchases to continue playing — this drives churn rather than revenue.
See Monetization Best Practices for detailed guidance.

Discovery and Acquisition

Invest in High-Quality Assets

Your game’s icon, cover image, and video are the primary tools for attracting players from discovery surfaces. Invest time in creating:
  • A game icon that is distinctive, readable at small sizes, and representative of your game.
  • A cover image that showcases actual gameplay (not just logos or characters).
  • A gameplay video that demonstrates the core experience in the first few seconds.
See Asset Design Guidelines for specifications and requirements.

Optimize for Organic Discovery

The platform’s algorithms promote games based on player engagement signals. To improve your game’s organic reach:
  • Maintain a high Day 1 and Day 7 retention rate.
  • Encourage social interactions (shares, challenges, tournament participation).
  • Update your game regularly with new content.
  • Respond to player feedback and fix bugs promptly.

Use Click-to-Play Ads Strategically

Click-to-Play (C2P) ads let potential players try your game directly from an ad unit. When combined with proper targeting and measurement, C2P can be a cost-effective acquisition channel. See Click-to-Play Ads for best practices on targeting, budgeting, and creative.

Retention

Create Reasons to Return

The biggest challenge for any Instant Game is getting players to come back after their first session. Effective retention strategies include:
  • Daily rewards: Offer escalating daily login bonuses to incentivize consecutive-day returns.
  • Progress systems: Levels, unlockables, and skill-based progression give players a reason to continue.
  • Social competition: Leaderboards and tournaments create ongoing competitive motivation.
  • Content updates: New levels, events, and seasonal content keep the experience fresh.

Use Notifications Wisely

Notifications are a powerful re-engagement tool, but overuse will lead to players disabling them. Best practices:
  • Send notifications that are timely and relevant — a friend beating their score, a tournament starting, or a reward expiring.
  • Deliver on the promise. When a player taps a notification, the game should immediately surface the context that was promised. If a notification says “Your friend beat your score!”, the leaderboard showing that friend’s score should be the first thing the player sees. Broken promises between notification content and in-game experience erode notification credibility over time.
  • Avoid generic “come back and play” messages.
  • Limit notification frequency to avoid fatigue.
  • Personalize notifications with context (friend names, specific game events).

Prompt Home Screen Shortcuts

Players who add your game to their device’s home screen are significantly more likely to return. Prompt the shortcut at a moment of high engagement — after completing a level, achieving a high score, or receiving a reward — rather than immediately on first launch.

Quality and Polish

Meet the Quality Guidelines

Before your game can go live, it must pass a quality review. Common reasons for rejection include:
  • No tutorial or unclear onboarding.
  • Missing basic UI elements (volume control, pause button, back navigation).
  • Excessive or poorly timed ads.
  • Poor performance or crashes on common devices.
  • Assets that do not meet design guidelines.
Thoroughly review the Quality Guidelines before submitting your game for review.

Test Thoroughly

  • Test on multiple devices (iOS, Android, web) and screen sizes.
  • Test with slow network connections to ensure graceful degradation.
  • Test the complete player flow: discovery, loading, tutorial, gameplay, monetization, sharing, and re-engagement.
  • Test gesture-based controls on different screen sizes and with different grip styles.
  • Use test users to verify social features work correctly.

Next Steps