We will test your app so be sure that we can access it. We will follow your screen recordings when testing your app, so make sure they demonstrate actions that require the permissions and features you are requesting. Any requested permission or feature missing a screen recording will not be approved.
Before you begin the App Review submission process, make sure to complete each of the steps outlined below. This will improve the quality of your submission and reduce the chances of it being rejected.
Make sure we can access your app or website. Your app must be publicly available or you must provide instructions on how to access it.
Upload a 1024x1024 compliant app icon image to Settings > Basic > App Icon.
Make at least 1 successful API call using each permission for which you are requesting advanced access. Calls must be made within 30 days of submitting for App Review and can be made using your app or the Graph API Explorer tool.
Read our Platform Terms and Developer Policies to ensure your app adheres to our terms and policies.
Read the Allowed Usage section in the reference for each permission and feature that you will be requesting in your submission. If your app does not satisfy the allowed usage for a permission or feature, your app will not be approved for that permission or feature.
Read our screen recordings guide. Make sure to record in high-resolution, 1080 or better, and that your screen recordings show an app user granting your app each permission your app requires, and that it shows how your app uses each granted permission and feature that you will be requesting in your submission.
Make sure your app's name and icon meet our trademark and logo requirements.
Read our FAQs regarding policy violations and the App Review process.
Read our Common Mistakes guide to avoid common mistakes found in first-time submissions.
If you have access to dedicated screen recording software such as Camtasia or Snagit, we recommend that you use it. Most dedicated screen recording software offer free trial versions and provide tools so you can polish your screen recording.
IIf you don't have access to dedicated screen recording software, you can easily use free alternatives, such as Quicktime or OBS. These apps don't offer any way for you to annotate, zoom, or edit your recorded video, but you can easily add the recorded video to a free video editor such as iMovie and perform those actions there.
Record only what we need to see. Make your app full screen or just record the window itself.
Decrease your monitor's resolution to a width of 1440 or less.
When possible, use your mouse to interact with your app instead of your keyboard. If we can't see what you're doing, we can't test it!
Increase your mouse's cursor size. Most dedicated screen recording software will allow you to do this, even after you have recorded. Alternatively, you can increase your cursor's size in your computer's settings.
Omit audio; our reviewers will not listen to it.
We will use your recordings as guides when testing your app to verify that it actually uses all of the permissions and features you are requesting. Recordings do not need to explain why your app needs each of them, the App Review submission form will ask for this information.
Use this guide to help you create an App Review submission once you have completed all app development and need to request approval for specific permissions and features. After you receive your App Review results, any app user will be able to grant your app any permissions for which you have been approved.
Find more video resources from Data Protocol.
Go to the App Review > Permissions and Features tab.
Request each of the permissions and features that your app needs by searching for them individually and clicking their Request advanced access button to add them to your submission. Only request the permissions and features that your app needs.
Note that the Request advanced access button will remain grayed out until a successful API has been logged in our system. A successful call must be made within 30 days of submitting for App Review. You are required to make at least 1 successful API call using each permission for which you are requesting advanced access. The API call data will be logged within 2 days of your successful API call. Calls can be made using your app or the Graph API Explorer tool.
Some permissions will also require access verification before you can apply for them.
Learn more about access verification.
Once you're ready, click the Continue the Request button.
After selecting your permissions and features, you may be prompted to complete business verification if you have not done so already. Depending on the status of your business, you may be asked to start verification, provide more information, or complete the process.
If your business verification status has already been approved, you may be prompted to answer data handling questions. Your responses to these questions will be immediately evaluated and could take up to 30 seconds.
Scroll down to the Complete App Settings section and click anywhere in the row. The window that appears displays required settings that can be found in the Settings > Basic tab, so these may already be complete. If they are, just confirm that everything is correct or make adjustments as needed. If any are incomplete, set them here.
Make sure your App Icon does not include any of our trademarks or logos.
This is the URL that we present to app users in the Facebook Login interface so they can decide whether or not to grant your app any permissions it is requesting.
Set this to Yourself or your own business if your app is only available to people who have a role on your app, or a role in a Business that has claimed your app. Otherwise set it to Clients.
Make sure to select a category that accurately describes your app.
Make sure you have access to the email account displayed here. Email notifications pertaining to your App Review submission will be sent to this address.
Scroll down to the Complete App Verification section and click anywhere in the row. This will display the App Verification Details window. If app users can sign into your app using Facebook Login or any of our authentication solutions, set the radio button to Yes. This lets us know that we can access your app using a Facebook account.
In the Platform Settings section, confirm that the information displayed is correct, and in the space provided, describe how we can access your app in order to test it.
We will test your app using our own test accounts. Do not include your personal Facebook account's credentials.
Scroll down to the Requested Permissions and Features section and click on the first permission or feature in the row. In the window that appears, describe why your app needs this permission or feature.
Be as specific as possible with your description. If you're having difficulty describing why your app needs the permission or feature, try answering these questions:
Next, upload your screen recording that shows us how to use your app to test this permission or feature.
Repeat Step 3 for every permission and feature that you are requesting.
Each permission and feature must have its own description. Do not copy and paste.
Click Submit for Review and agree to our Platform Onboarding Terms in the window that appears. Once you accept the terms and submit, your submission will be queued and you should receive a decision within a week.
If your app has modes, you should only switch it to Live mode after you have completed App Review. Apps in Live mode can only request approved permissions from app users, and only approved features will be active for app users. This restriction applies to everyone, even users who have a role on the app itself, so switching to Live mode prematurely may make your app unusable for users who have a role on your app. In addition, data generated while in Development mode such as test posts will become visible to all app users once you switch.