Build

New Apps Onboarding

Select connection experience settings option

  1. From the dashboard, go to Use Cases > Customize "Launch a game on Facebook" > Network Connection Settings > Connection Experience Settings. If you do not see Use Cases, Network Connection Settings will be within the left sidebar nested within the Instant Games Product.
  2. Select Zero Permissions and hit confirm selection.

Testing the game in Network Enabled Zero Permissions Environment

  1. Go to Use Cases > Customize "Launch a game on Facebook" > Web Hosting. If you do not see Use Cases, Web Hosting is likely on the sidebar on the left side of the screen under Instant Games.
  2. Upload your Zero Permissions compatible bundle. Hit play to test the game.
  3. A debug tool is also built in to help debug any issues that arise, for more instructions on the tool, refer to Network Enabled Zero Permissions > Debugging Tool.

Request advanced access to the Instant Games Zero Permissions feature

  1. Go to Use Cases > Customize "Launch a game on Facebook" > Permissions. If you do not see Use Cases, go to App Review > Permissions and Features on your left sidebar.
  2. Add Instant Games Zero Permissions Access to your App Review
  3. Complete your app review.
  4. Once the app review is completed, you will be able to publish and launch your game.

Existing Apps Migration

Note that once you select Zero Permissions as the Connection Experience, all of your Platform Test Users will default to load your game in the Zero Permissions model.

Select connection experience settings option

  1. From the dashboard, go to Use Cases > Customize "Launch a game on Facebook" > Network Connection Settings > Connection Experience Settings.

    2. If you do not see Use Cases, you can find Network Connection Settings in the details tab under Instant Games.

  2. Select Zero Permissions and hit confirm selection.

Testing the game in Network Enabled Zero Permissions Environment

  1. Go to Use Cases > Customize "Launch a game on Facebook" > Web Hosting. If you do not see Use Cases, Web Hosting is likely on the sidebar on the left side of the screen under Instant Games.
  2. Upload your Zero Permissions compatible bundle.
  3. Toggle Network Enabled Zero Permission Settings at the top of the page.
  4. Once the scanning completes, hit ‘Play in NEZP’ to test the game.
  5. A debug tool is also built in to help debug any issues that arise, for more instructions on the tool, refer to Network Enabled Zero Permissions > Debugging Tool.
  6. Mark the desired production zero permissions bundle with the ‘shield’ icon.

Confirm data deletion

Please note that our Platform Terms prohibits any attempt to re-identify or de-anonymize users.

  1. Go to Use Cases > Customize "Launch a game on Facebook" > Network Connection Settings > User Data Deletion. If you do not see Use Cases, Network Connection Settings is likely on your left side bar.
  2. Delete any personally identifiable user information that were previously stored including but not limited to:
    • Name
    • Profile picture
    • Friend’s name
    • Friend’s profile picture
  3. Note: Player ID should not be deleted, and player progress data can be retained.
    • To understand more about data deletion requirement, please read the FAQ.
  4. Attest data deletion by checking the checkbox next to "I confirm that I have deleted and will not retain any personally identifiable information...", and hit Save.

Request advanced access to the Instant Games Zero Permissions feature

  1. Go to Use Cases > Customize "Launch a game on Facebook" > Permissions. If you do not see Use Cases, go to App Review > Permissions and Features on your sidebar.
  2. Add Instant Games Zero Permissions Access to your App Review
  3. Complete your app review.
  4. Once the app review is completed, you will be able to start migrating your app.

Migrate users to Network Enabled Zero Permissions bundle

  1. Go to Use Cases > Customize "Launch a game on Facebook" > Network Connection Settings > Zero permissions rollout. If you do not see Use Cases, Network Connection Settings is likely on your left side bar.
  2. If the migration component is still disabled, hover over the "i" icon next to "Rollout Percentage" for more information.
  3. Choose a rollout percentage to migrate the selected percentage of production users to Network Enabled Zero Permissions bundle.
  4. Monitor the performance of the game live in production.
  5. Continue to rollout until 100% and we are done!
    • Note that after completing the migration to zero permission, you’ll have a new way to push game bundles into production in web hosting tab. Simply tap the star icon in the status column for the bundle to load it to the zero permissions environment for users.
    • Similarly, to test your instant game in zero permissions, tap play under Web Hosting > Manage Hosted Assets.

Network Enabled Zero Permissions for Messenger Calls

Upload a NEZP Messenger Calls version

  1. Navigate to the Web hosting page.
  2. Confirm you have a Messenger Calls version. This is your current, non-NEZP Messenger Calls version of your game.
    • If you see a banner like this on top of the page, then you do not have currently a Messenger Calls version and that your current production version is being used as your Messenger Calls version. You must have a separate Messenger Calls version for the NEZP migration.
    • Upload a copy of your current production version and then push that version to Messenger Calls by clicking on the button with the video icon. Refresh the page.
    • Confirm you see your Messenger Calls version and then proceed to the next step.
  3. Upload a NEZP-compatible Messenger Calls version of your game.
    • Push the version to NEZP for Messenger Calls by clicking the button with the shield and video icon.
    • Confirm you see your NEZP for Messenger Calls version.
  4. Now you have two Messenger Calls versions. Users who are eligible for NEZP will receive the NEZP Messenger Calls version of your game and users are not will receive the non-NEZP version.

Testing the NEZP Messenger Calls version

Prerequisites

NEZP for Messenger Calls is only supported on these clients:

  • Messenger Web
  • Messenger iOS version 517 or above
  • Messenger Android version 519 or above

Users not one on these supported clients will receive the non-NEZP version of your Messenger Calls game.

As of August 2025, NEZP for Messenger Calls is only available to users with Facebook developer accounts. We are restricting access to only developers for now since this is a new feature. We plan to gradually roll out to all end users towards the end of August 2025 once we receive confirmation from developers.

Steps

  1. Make sure you have NEZP environment toggled on for your user.
    • This toggle only affects the current user. For each user you're going to test with, you must log in as that user and toggle on the NEZP environment.
  2. Start a Web Messenger Call with another user and find and start your game in the game list.
  3. Confirm your game loads successfully in the NEZP environment
    • Confirm your game is in the NEZP environment by going to the Chrome developer tool's console tab. You should see in the dropdown an entry for index.html from shield-apps-(your app id)

Testing the non-NEZP Messenger Calls version

  1. Make sure your have the NEZP environment toggled off for your user.
  2. Start a Web Messenger Call with another user and find your game in the game list.
  3. Confirm your game loads successfully in the non-NEZP environment
    • Confirm your game is in the non-NEZP environment by going to the Chrome developer tool's console tab. You should see in the dropdown an entry for index.html from apps-(your app id) (there is no leading shield prefix in the name)