Facebook Login Sample Submission

Let's say you've developed an app that allows users to create party invitations. Your app needs access to user data, so you've implemented Facebook Login with the user_photos, user_location, and user_age_range Permissions. You've read each Permission's description, as well as our Platform Policy, and have verified that your app uses data in an approved manner. Your app is now ready for public use, so you begin the app review process.

Adding Permissions

You sign into your app dashboard, click App Review, then click Permissions and Features.

Your app needs the user_photos, user_location, and user_age_range Permissions, so you use the search field to locate and add each of them to your submission.

Describing Data Usage

Now you explain how you will use the data that each Permission allows your app to access. You start with the user_photos Permission. You click Requests, then the continue icon in the Tell us how you'll use user_location row.

Provide a general description of what your app does, explaining how the user_photos Permission will provide value to your app users.

You enter the following description in the Tell Us Why You Are Requesting user_photos section:

"My app allows users to easily schedule parties, and create and send custom party invitations, using their location, age range, and photos. The user_photos permission allows users to access their photos so they can customize their account profile icon and add photos to any party invitations they create. Adding personal photos to invitations increases the likelihood that recipients who know the user will accept an invitation."

Uploading a Screen Recording

In the Tell Us Why You Are Requesting user_photos section, you upload a short, 1-minute screen recording of a user signing into your app and customizing their account profile photo and party invitation with photos from their Facebook account.

You upload the following screen recording and click Save.

Something Went Wrong
We're having trouble playing this video.

Now that you've supplied details for the user_photos Permission, you repeat these steps for the user_location and user_age_range Permissions. Since your screen recording shows how all three Permissions are used, you use the same screen recording for all of them.

Complete App Verification

In the Provide verification details row, click the continue icon and enter instructions that a submission reviewer can follow to verify that your app uses all the Permissions you have requested in the way you have described. You also indicate when this happens in the screen recording that you have uploaded.

You enter the following:

"To see how my app uses these permissions:

  1. Go to partypal.com and click 'Continue with Facebook'.
  2. Click 'Continue as...' to allow the app to access your name and profile pic.
  3. This page uses the default permission to grab the user's first name and profile pic, and displays them both. Click your profile pic.
  4. Click the 'Import' button.
  5. Click 'Continue as...' to allow the app to access your photos.
  6. This windows uses user_photos to grab the first 30 photos in the user's account and displays them. Select a photo.
  7. Click 'Choose a location'.
  8. Click 'Continue as...' to allow the app to access your current city and age range.
  9. This window uses user_age_range and user_location to determine the user's approximate age and location, then grabs a list of nearby, age appropriate venues (which it gets from another service). Select a location.
  10. In the invitation composer, click the image.
  11. This window uses user_photos again to grab the first 30 photos in the user's account and displays them. Select a photo.

The accompanying screencast shows user_photos being requested at the 18-second mark, and it shows the user's photos being accessed at the 23- and 51-second marks. At the 52-second mark user_location and user_age_range are requested when a user clicks 'Choose a location'."

You then save your details.


You have supplied everything a reviewer will need to verify that your app uses the user_photos, user_location, and user_age_range Permissions in an approved manner, so you click Submit For Review.