Instant Games
What's New
Updated: Aug 3, 2026
Get notified
What's New (13)
Aug 3, 2026
Build

New guide for migrating to Network Enabled Zero Permissions

We’ve added Migrating to Network Enabled Zero Permissions, a step-by-step guide for developers moving a live Instant Game built on SDK v7.1 or earlier from the standard permissions environment to Network Enabled Zero Permissions.
The guide covers upgrading your build to SDK v8.0 and removing unsupported APIs, declaring external domains in your Content Security Policy configuration, selecting Zero Permissions in Network Connection Settings, confirming user data deletion, requesting advanced access to Instant Games Zero Permissions Access, replacing player-identifying UI with overlay views, testing the shield bundle, submitting for app review, and rolling out incrementally to production.
The guide also documents the migration deadline. Games must complete their migration to Network Enabled Zero Permissions by September 30, 2026, after which they will no longer be accessible to players on Facebook.

Bulk IAP catalog operations now have per-operation limits

The App Dashboard now adds a maximum of 20 products per operation and deletes a maximum of 8 products per operation. Adding covers both CSV import and adding products manually. See Bulk operation limits in the In-App Purchases guide.
The limits apply per operation rather than to your catalog as a whole, so you can repeat an operation to manage a larger catalog. Split any CSV file containing more than 20 products.
The Instant Games IAP Catalog API is unchanged. Each request handles a single product, so no batch limit applies.
Jul 16, 2026
Build

New destroyAsync() method for overlay views

We’ve documented destroyAsync() on the OverlayView object in the FBInstant.overlayViews reference. Unlike dismissAsync(), which only hides an overlay view so it can be shown again later, destroyAsync() permanently destroys the overlay view, removes its iframe element from the DOM, and releases its resources. Use it to free up memory for overlay views you no longer need.
Jul 13, 2026
Build

Adjusted migration timeline for games actively migrating

We’ve added an Additional Time for Games Actively Migrating section to the Canvas Game Migration guide. Games that demonstrate they are actively migrating by August 31, 2026 qualify for an adjusted timeline (IAP off December 1, 2026; Web Games no longer accessible December 30, 2026). The guide details how to qualify when migrating with the same app ID or a different app ID, as well as the standard timeline (IAP off September 1, 2026; Web Games no longer accessible September 30, 2026) for games that are not migrating.
Jul 9, 2026
Launch

Content Distribution Updates

We’ve made some changes to how games are reviewed and distributed:
  • Quality Review Simplification: This process is now streamlined, and focuses on more objective criteria to identify if a game is meeting baseline quality expectations. Existing games that have already gone through quality review do not need to resubmit for quality review.
  • PQC Deprecated: Platform Quality Criteria (PQC) is now deprecated. The review process is now streamlined -- games that pass quality review are eligible for distribution on the Play Tab, without the need to meet separate PQC metric thresholds.
  • New Tiering System: Game content distribution is now determined by your game’s tier. This is a data-driven system that ranks games daily based on three player-derived signals: User Ratings, New User Retention, and Weekly Active Retention. Games are ranked regionally and placed into distribution tiers that determine game discoverability. Tier placement is visible on the Developer Portal, and the new tiers now include: Promoted, Standard, Limited, and Restricted.
Jun 7, 2026
Build

Expanded Canvas Game Migration guide

The Canvas Game Migration guide has been updated with additional guidance for migrating from Canvas Games to Instant Games with Network Enabled Zero Permissions (NEZP):
  • Submit your game for app review — Added a step covering how to submit your application for app review through Instant Games > Review > App Review for Instant Games before rolling out to players.
  • Application Migration — Added context on linking differing Canvas and Instant Game App IDs through Gaming Services > Migration so player identity can be mapped between them.
  • NEZP and CSP — Clarified how Network Enabled Zero Permissions and the Content Security Policy (CSP) allowlist govern external requests from your game.
  • Troubleshooting — Added an “Unable to connect or call external resources” entry explaining sandbox behavior and how to allowlist external resources.
Apr 28, 2026
Build

FBInstant.openExternalLinkAsync() is now available in Instant Games SDK v8.0.

FBInstant.openExternalLinkAsync(url) is now available in Instant Games SDK v8.0 for approved external URLs after platform confirmation.
Use this API when you need to send players to an approved external destination, such as a help center, support page, or publisher-managed website. The call resolves after the platform confirms and attempts to open the link, and rejects if the player cancels, the URL is invalid, or the client definitively fails to dispatch the request.
Before calling this API, check FBInstant.getSupportedAPIs() to confirm that openExternalLinkAsync is available on the current client.
Apr 28, 2026
Monetize

IAP Payment Webhooks

You can now subscribe to IAP Payment Webhooks to receive real-time server-to-server notifications when an in-app purchase succeeds or a refund is processed. Webhooks provide a reliable server-side signal that complements the client-side SDK flow, ensuring your game is notified of purchase events even if the player closes the game mid-purchase or experiences a network interruption.
Key capabilities:
  • Subscribe via the App Dashboard — Configure your webhook callback URL and verify token in the Use Cases > Webhooks section.
  • V2 payload format — Webhook notifications include the product ID, user ID, purchase platform, price, currency, purchase token, and payment environment.
  • Two event types — PURCHASE_SUCCESS for completed purchases and REFUND_SUCCESS for processed refunds.
  • Test from the App Dashboard — Verify your callback URL and send test webhook payloads directly from the UI before going live.
For setup instructions, payload reference, and handling guidance, see IAP Payment Webhooks.
Apr 14, 2026
Monetize

Rewarded Interstitial Ads API has been fully removed from the FBInstant SDK.

The Rewarded Interstitial Ads (RIA) API has been fully removed from the FBInstant SDK libraries. RIA was deprecated on November 15, 2025 and has been returning NO_FILL since that date. This removal is part of our effort to improve the overall quality of the ad experience by reducing game interruptions for players.
If you have not migrated away from Rewarded Interstitial Ads since November 2025, your code may break. Because the API has been removed from the SDK, any calls to the Rewarded Interstitial Ads API will fail.
We recommend adopting one of the following monetization alternatives:
  • Rewarded Video Ads — players opt in to watch a video ad in exchange for an in-game reward
  • In-App Purchases — offer virtual goods, currency, or premium content directly to players
Apr 8, 2026
Build

Instant Games Unity Plugin now available — build Instant Games in Unity with full C# SDK access, and Zero Permissions overlay views.

The Instant Games Unity Plugin is now available on GitHub⁠. The plugin provides a C# wrapper around the Facebook Instant Games SDK, enabling Unity WebGL games to access platform features without writing JavaScript.

Features

  • Full FBInstant SDK coverage — Player identity, social contexts, payments, tournaments, ads, matchmaking, and more, all accessible from C#
  • Async/Await API — All SDK calls use C# Task-based async patterns
  • Overlay views (NEZP) — Display player names, profile pictures, and social data securely through Meta-controlled iframes under the Zero Permissions model
  • Editor mocking — API calls return mock data in the Unity Editor so you can test without a browser
  • Editor tools — Built-in windows for bundle uploading, project optimization, and visual overlay view building

Requirements

  • Unity 2022 or later
  • Unity WebGL build target
Apr 4, 2026
Monetize

We are deprecating banner ads on the Instant Games platform. Starting April 2026, the number of banner ad impressions served across all games will gradually decrease, reaching full deprecation by March 31, 2027.
  • Updated Banner Ads documentation with deprecation notice and FAQ
  • Your game will continue to function normally — no code changes are required
  • Banner ad impressions will decrease gradually — there will not be a sudden cut-off
We recommend integrating alternative monetization formats in place of banner ads:
  • Rewarded Video Ads — players opt in to watch a video ad in exchange for an in-game reward
  • In-App Purchases — offer virtual goods, currency, or premium content directly to players
Both options are available today.
Apr 4, 2026
Build

Canvas deprecation reminder (September 30, 2026) with enhanced rollout controls, cross-play support, and upcoming IAP payment status webhooks.

As announced in July 2025, the Canvas platform will be deprecated on September 30, 2026. All Canvas and Instant Games must migrate to the Zero Permissions framework before this date.
We are continuing to invest in tools and capabilities to make migration easier:
  • Enhanced rollout controls — You can now migrate specific users to your Zero Permissions build, including the ability to target payer vs. non-payer users, before rolling out to your full player base. See the Canvas Game Migration guide for details.
  • Cross-play support — For eligible apps, we support cross-play between your Instant Game (NEZP) and off-platform apps, allowing players to maintain progress across platforms.
  • IAP payment status webhooks — Coming in the next few weeks, payment status webhooks will provide real-time notifications for In-App Purchase transaction events, improving reliability for your purchase flows.
Feb 25, 2026
Launch

Legacy bundle upload API endpoint is being deprecated on May 26, 2026. Migrate to the new two-step Bundle Upload Service.

The legacy bundle upload API endpoint (graph-video.facebook.com/{APP_ID}/assets) is deprecated and will be removed on May 26, 2026. Migrate to the new Bundle Upload Service, which uses a two-step upload flow:
  1. Create an upload session via the Graph API (graph.facebook.com/v24.0/{APP_ID}/uploads)
  2. Upload your bundle binary using the session ID
After uploading, use the new push-to-production endpoint to publish your bundle. The new service supports resumable uploads and explicit version control.
If you upload bundles manually through the Developer Portal, no action is needed — manual uploads already use the new service.
Jul 31, 2025
Build

Important changes to Web Games and Instant Games on Facebook, Network Enabled Zero Permissions (NEZP) is now General Availability.

Network Enabled Zero Permissions (NEZP) is now General Availability with Instant Games SDK API v8.0. This new connection model limits user data shared outside Meta while enabling richer social experiences.
Key Dates & Deadlines:
DateChange
August 1, 2025
All newly created Instant Games must use Zero Permissions as the connection experience. Standard (blocking permissions) connection is no longer available for new apps.
September 30, 2026
Sunset of Web Games on Facebook. Web Games will no longer be available unless migrated to Instant Games with Zero Permissions. Existing Instant Games (created on or before July 31, 2025) can continue using the standard connection experience until this date.
Required Migrations:
  • All existing Instant Games and Web Games must migrate to “Instant Games with Zero Permissions” before September 30, 2026.
  • Seamless App ID migration is supported (no new app required).
  • Granular rollout control tools are available for phased migration.
  • Limited cross-play support between Facebook Instant Games and Native Games.
Read the full announcement on Meta Developer Blog.
Filter