Test Users

We are temporarily removing the ability for apps to create new test users. This should not affect existing test users or apps actively undergoing compliance assessments. We will share an update once access to creating new test users has been reinstated.

Unlike Testers, who are real people who have been granted a Tester role on your app, test users are simulated Facebook user accounts that you can use to test your app's implementation of Facebook Login and any permissions or features your app uses.

Screenshot of Roles > Test Users in left-hand menu and Roles > Test Users panel displayed.

Test users cannot interact with real Facebook users, and any data you generate with a test user will only be visible to other test users on your app, or to real Facebook users who have an Administrator, Developer, or Tester role on your app. Test users are exempt from our spam and fake account detection systems, so they won't be disabled when you use them to test your app.

You can create, edit, delete, and login as a test user through your App Dashboard or the Graph API.

Limitations

  • Apps are limited to 10 test users.
  • Do not create or maintain more test users than reasonably needed to test your app integration.
  • Test users must only be used to test your app integration or simulate how your app performs.
  • Test users can only be created by app Administrators or Developers.
  • Test users can grant your app any permission while it is in Development mode but can only grant approved permissions while it is in Live Mode.
  • All features are active for test users while your app is in Development mode but only approved features are active for test users while it is in Live mode.
  • Test users can only interact with other test users, or real users who have an Administrator, Developer, or Tester role on the app.
  • Data generated by a test user can only be seen by other test users or real users who have a Administrator, Developer, or Tester role on the app.
  • Test users can only interact with app-scoped test pages.
  • Test users can only comment on app Posts published via a Facebook Share Dialog or the Graph API.
  • Test users cannot be converted to real users.
  • Test users can only make enough API calls to simulate how an app performs in Live mode. They are rate limited differently than users who have a role on the app.

Creating Test Users

You can create test users in the App Dashboard by going to the Test Users section in the Roles > Test Users panel and clicking the Create test users button. This will open a dialog that allows you create up to 4 test users at once.

Screenshot of Roles > Test Users in left-hand menu and Roles > Test Users panel displayed.

You can also choose to install the app for each of these users, which means to grant your app each of the permissions (authorization) you specify at the time of creation (you can always grant others permissions later).

The Create Test Facebook Accounts dialog allows you to:

  • Create up to 4 test users at a time. If you want to create more in bulk, you should use the Graph API instead.
  • Select whether each newly created test account will have the app installed by default.
  • Select the Graph API version to use in calls.
  • Grant permissions for the app for each test user.
  • Add age restrictions.
  • Choose the locale that the test accounts will use to view Facebook.

Once created, test users will appear in the Facebook Accounts table.

Testing With Test Users

You can test your app with a test user by signing into Facebook Login using the test user account's credentials and granting your app any permissions it needs. You can also grant your app permissions on behalf of a test user by clicking the ellipsis icon (•••) in the Options column within a given test user's row in the Facebook Accounts table. Clicking the ellipsis icon will give you the option to edit the permissions the test user has granted your app, generate User access tokens for the test user, and log into the test user's account.

Screenshot of Options ellipsis dropdown menu.

Managing Test Users

The App Dashboard shows you a list of existing test users and allows you to edit the settings of any test user.

You can:

  • Change the name or password for a test user.
  • Change permissions a test user granted to an app.
  • Get a valid access token for each test user.
  • Add and delete this test user's friends.
  • Get a new access token for a test user when an existing access token expires.
  • Log in as the test user.
  • Change the Graph API version used in calls for a test user.
  • Delete any test user.

If you want to associate or disassociate an existing test user with other apps you will have to use the Graph API.

Test User Graph API Endpoints

If the App Dashboard is not sufficient for your needs or you would like to create more than 4 test users at a time you can use the Graph API.

App Administrators and Developers can use the Application Accounts endpoint to:

  • Create new test user accounts for an app.
  • Get a list of existing test users associated with an app.
  • Get a valid access token for each test user.
  • Associate and disassociate existing test users with an app.
  • Get a URL to use to login as a test user.

App Administrators and Developers can use the Test Account endpoint to:

  • See details about a test user.
  • Update a test user's name or password.
  • Delete a test user.
  • Create friend connections between test users.