Introduction

App Review is a process that enables us to verify that your app uses our products and APIs in an approved manner. It is dependent on your app's use of individual permissions and features while in Live mode.

App Modes

Apps in Development mode can be granted any permission, but only from app users who have a role on the app or a role in a Business that has claimed the app. This effectively limits an app's user base to only those users who have a role on the app or claimant Business.

Apps in Live mode can be granted permissions by anyone, but only permissions that have been approved through the App Review process. This expands an app's user base to everyone, but restricts which permissions can be granted to the app, even by app users who have a role on the app or Business.

Features work similarly to permissions in that they are only active for app users who have a role on the app or claimant Business while it is in Development mode. Once switched to Live mode, features become active for all users, but only features that have been approved through the App Review process.

If your app will be used by app users who do not have a role on the app itself or a role in a Business that has claimed it, it must first undergo App Review for each permission and feature that it needs before it can be switched to Live mode.

If your app will only be used by app users who have a role on the app or claimant Business, App Review is not required and your app does not need to be switched to Live mode.

App Review Panel

The App Review process starts in the App Dashboard's App Review panel.

Screenshot of App Review > Permissions and Features in left-hand menu and App Review > Permissions and Features panel displayed.

After you have completed all app development, read our Before You Submit document and then follow our Submitting For Review guide to request approval for the permissions and features your app needs. When you submit, you must describe how each permission and features is used by your app. You will also have to upload screen recordings showing our reviwers how to test you app so we can verify that it's in compliance with our usage policies.

Screen Recordings

As part of the submission process you will likely be required to upload screen recordings showing your app using each Permission and Feature that you are requesting. We've created a Screen Recording guide that explains what to capture in your recordings.

Developer Notifications

Once you have submitted an App Review request, you will receive periodic developer notifications informing you of your submission status. These alerts will appear in the in your Alert > Inbox. You can also check your submission status using the App Review > Requests panel.

It typically takes us less than one week to process your submission, and often takes only 2–3 days, but may take longer during peak periods.

App Review for Live Apps

If your app is already in Live mode and you want to release new functionality that requires App Review, or change how your app uses Facebook data, create a test app from your live app and use it for new development. Test apps are child apps that are always in Development mode and inherit all of the settings of their parents.

  1. Perform all new development and testing using the test app and an app user who has role on the test or parent app, or business that has claimed either of them.
  2. Capture screen recordings that demonstrate how your test app uses the new permissions and features.
  3. Switch back to you parent live app in the App Dashboard and start a new App Review submission using your newly captured screencasts.
  4. In the submission verification details section, include the name and ID of your test app and clearly describe how we can test it. If your test app is on a private network or you want us to test with a specific test user, include any credentials we may need in order to test it properly.
  5. Submit your submission.

Note that apps that have been typed as Business apps do not have app modes and instead rely on access levels. To release new reviewable functionality for a Business app, test the new permissions and features that you need with any user who has a role on the app itself or claimant business and then request advanced access for those permissions and features in an App Review submission.

Product-Specific App Review

Some products require specialized review steps. When you add any of these products, their product tab will appear in the App Dashboard along with an App Review section that lists any specialized Permissions, Features, and instructions.

Product-Specific App Review is independent of general App Review, so in order to submit for Product-Specific App Review you must use the respective product's tab.