Screen Recordings

The purpose of a screen recording is to show a submission reviewer how to test your app's usage of every Permission and Feature included in your submission. If a reviewer is unable to follow your screen recording and test your app successfully, your submission will be rejected.

Follow these guidelines to ensure that your screen recording includes everything a reviewer needs to test your app successfully.

Show Your Complete Login Flow

Our reviewers need to see how an app user logs into your app.

  1. Before you start recording, log out of any test accounts you are using.
  2. Capture the entire Facebook Login flow, from logged-out to logged-in. If your app users can create accounts and log into your app without the use of Facebook Login, also capture this flow.

  3. The following example screen recordings clearly show that app users log into the app without Facebook Login, but later use Facebook Login to grant the app access to their Facebook data.

    Example — A logged-out user before logging in:

    Example — The user logging in without the aid of Facebook Login:

    Example — The logged-in user attempting to access their Facebook data:

    Example — The logged-in user using Facebook Login to connect to their Facebook account:

Show Permission Granting

If your app users rely on Facebook Login to grant your app Permissions to access their data, show an app user locating the Facebook Login button and using it to grant your app every Permission that you have included in your App Review submission.

A reviewer will attempt to use Facebook Login and their own test user account to grant your app all of the Permissions in your submission. If the reviewer is unable to grant your app each Permission, your submission will be rejected.

Recommendation: Capture the complete authorization flow, as some permissions require additional confirmation from app users. For example, the pages_manage_engagement permission allows users to select specific Pages to authorize the app to access.

The following screenshots from a sample screen recording show Page selection.

Example — The user logging in with Facebook Login

Example — The user later granting the app access to a Page they manage

Show Data Usage

For each Permission and Feature in your submission, we recommend that you demonstrate when and how it is being used. Do this by capturing the entire usage flow.

For example, if your app allows app users to publish a Post on a Page, show us how app users can create a Post and how to view it after it has been Published to a Page.

  1. Begin the Post creation process.

  2. Create the Post content.

  3. Publish the Post.

  4. Example — The published Post on a Page

  5. Ensure that your screen recording shows your app using every Permission and Feature in your submission. If you omit one, it may not be clear to our reviewers how to test it, and your submission will be rejected.

For additional clarity, we recommend that you annotate your screen recording.

Best Practices

Use these best practices as optional tips to consider when recording your screen recording. These tips will help you create a screen recording that clearly demonstrates how your app uses each Permission and Feature in your submission, and can make your screen recording easier for our reviewers to follow.

General Tips

  • 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 provide tools for annotation, zooming, and basic timeline editing so you can polish your screen recording. Most dedicated screen recording software offer free trial versions.
  • If 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. If your app is not full screen, make it full screen or just record the window itself.
  • Decrease your monitor's resolution to a width of 1440 or less when you record. This helps us see what you're doing in your app.
  • 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 so it's easier for us to see. Most dedicated screen recording software will allow you to do this, even after you have recorded. Alternately, you can increase your cursor's size in your computer's settings.
  • Omit audio; our reviewers will not listen to it.

Script Your Recording

Before you actually record your screen recording:

  1. Make a list of all the Permissions and Features you need to show in your screen recording.
  2. Plan how to show each of them.
  3. Perform all of the actions on your list and adjust it if you encounter any problems.

Repeating this process a few times helps you identify any areas that are unclear and give you an excellent recording plan, which you can then follow when capturing your actual recording.


Most dedicated screen recording software and video editing software provide tools for adding annotations to your videos. Annotations are text and graphic overlays that allow you to provide notes for specific areas in a video. Annotations are a great way to highlight portions of your recording that show your app using a specific Permission or Feature.

For example, if your app relies on the user_photos Permission, you could use an annotation to point out exactly when your app relies on it to get a user's photos:

We recommend that you use annotations for all of the Permissions and Features that you are requesting. You should be able to find annotation tutorials for your dedicated screen recording software or video editing software online.

Zoom In

If your screen recording contains sections where it can be difficult to see what's happening, consider zooming in to any hard-to-see sections. Most dedicated screen recording apps will allow you to do this after you have recorded your screen recording. If you're not using dedicated screen recording software, you can use video editing software to do it after you have finished recording.

You should be able to find "zoom in" and "zoom out" tutorials for your dedicated screen recording software or video editing software online.

Use Test Users

We recommend that you create Test Users and use them in your screen recording recording. Include their credentials with your App Verification Details in your App Review submission so our reviewers can use them to test your app as well. This increases the likelihood that a reviewer can test your app exactly as you depicted in your screen recording.

If your app users are able to create accounts and log in to your app without the aid of Facebook Login, we also recommend that you include test user credentials for one of these users.