Migrate your Web Games to Zero Permissions

1. Create a new test application for Instant Games

To verify that your instant game bundle has been successfully converted from the Web Game version to the Network Enabled Zero Permission version, you should create a separate application to avoid disrupting existing players.

Follow the steps in How to test Zero Permissions to create your new Zero Permissions bundle. Upload that bundle to your test application to ensure that it is working as intended.

2. Add the Instant Games product to the original Web Game Application

Within the original Web Game portal, add the Instant Games product which will prompt you to fill in game metadata that will be used on game discovery and promotional surfaces including descriptions and media assets.

3. Configure your instant game

Now you will see the instant game product available on this application as well. From here you can configure the basic information about your game that will be used in promotional content and on discovery surfaces. You will also see the options to set up further integrations with social features and monetization features and can set them up for your Instant Game version.

Follow the steps outlined in the New Apps Onboarding section on the App Onboarding and Migration page. Importantly, remember to request advanced access to the Instant Games Zero Permission feature as outlined in that section.

4. Upload the instant game bundle on the Web Game Application

Take the bundle that you have verified on your test application and upload it to your original Web Game application in the Web Hosting tab of the Instant Games section. If your application was hosting bundles for your web games in the past, you will see separate tables containing your Canvas (Web Game) bundles and a new table for your Zero Permission Instant Game bundle. Mark the Zero Permissions bundle as Production.

5. Submit the application for Instant Game review

Once the metadata is completed and the bundle is uploaded, submit the game for Instant Game Quality Review and In-App Purchase review if necessary.

6. Confirm Data Deletion

In the Launch Status tab, you will need to confirm that you have deleted personally identifiable information received from Meta prior to starting the migration process of your existing users to Zero Permissions. As users with roles on the application, you will be able to test your application before this is completed.

7. Launch the Instant Game

Verify that there are no steps remaining in the Instant Game Health Check and launch the game so it will be discoverable by public users.

8. Migrate users from Web Games to Zero Permissions

With the bundle uploaded, navigate to the Launch Status tab under Instant Games (Previously: Migration tab under Gaming Services) and migrate the application to support Zero Permissions. This will redirect users to your uploaded Instant Game Zero Permissions bundle.

Once the migration is enabled, you can control the rollout and set the rollout percentage using the selector.

9. Monitor your Instant Game performance

Congratulations, the migration process is now complete! We recommend monitoring the overall health of your Instant Game to ensure your game’s growth and retention are performing to your expectations.