Account Kit Best Practices

The onboarding experience is one of the most important user experiences in your app. Account Kit lets people start using your app quickly and easily, using phone number or email.

Use the following tips and considerations to optimize your account creation flow. A high quality onboarding experience can improve conversion and create positive first impressions.

  1. Prompt people to log in at the right time
  2. Choose phone number, email or both
  3. Customize the UI
  4. Test your implementation
  5. Track your results
  6. Keep your app secure
  7. Follow the Account Kit Platform Policy

1. Prompt People to Log in at the Right Time

The best experience is to let people use your app and see its content before prompting them to log in. For example, BattleText allows people to play the game and explore before logging in - it's only when the person wants to challenge friends that they need to create an account.

2. Choose Phone number, Email, or Both


  • Choose email when your implementation is primarily web-based, or when people using your service are likely to expect email registration.


  • Choose phone number when people are likely to use your service on their mobile phone or unlikely to have an email address.


  • Let people choose how to log into your service and implement both email and phone number with Account Kit.

3. Customize the UI

Choose colors and display for the Account Kit UI that match with your app design specs. This creates a more consistent experience for people using your app. You can customize for iOS, Android, and web.

Background Images:

  • Images that work best as backgrounds contain fewer objects in them and are simple in detail. For a more elegant look, try using images that don't use too many colors. You can fine tune contrast between your foreground UI and background by adjusting the tint opacity.
  • Choose a white tint with images that are bright to lighten the background. Choose a black tint with dark images to dim the background.


  • Ensure text and UI elements are visible to people using your app. Don't obscure any elements of the Account Kit user interface, and don't modify any element except where expressly permitted by our technical documentation. This is also a requirement of our platform policy.

Further Customization:

  • If you want to build a more customized UI, try the Advanced UI solution to make more specific changes to the look and feel of the Account Kit flow. Note, you cannot change the standard disclaimers or the basic layout of the pages.

4. Test Your Implementation

Make sure to test your configuration by getting it in front of people. Make sure it's easy for them to read text and identify buttons and navigation.

5. Track Your Results

Once you are ready to launch, we suggest using an analytics program to understand if people are completing the process and their overall conversion rates. Facebook Analytics lets you monitor your conversion rates for free. For details, App Events and Analytics for Account Kit.

6. Keep Your App Secure

Follow the recommendations in the Access Tokens topic to keep your app and your users secure when using Account Kit.

7. Follow the Account Kit Platform Policy

To avoid potential problems later on, do a quick check to make sure your Account Kit integration adheres to the Account Kit section of our policy .