---
title: "Create onboarding"
---

[Onboardings](onboardings) introduce new users to your mobile app's value, features, and usage tips.

## Step 1. Create an onboarding

To create a new onboarding in the Adapty dashboard:

1. Go to **Onboardings** from the Adapty main menu. This page gives an overview of all onboardings you’ve set up, along with their metrics. Click **Create onboarding**.

  <img src="/assets/shared/img/create-onboarding1.png"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

2. Create a descriptive name for your onboarding and click **Proceed to build onboarding**.

  <img src="/assets/shared/img/create-onboarding2.png"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '400px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

3. You will be redirected to the onboarding builder. 
   
   It contains a default demo template, which you can study to understand how onboardings collect data and how you can personalize them using variables and quizzes. Feel free to remove any screens you don't need and [design your own onboarding experience](design-onboarding) there.

  <img src="/assets/shared/img/create-onboarding3.png"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

4. When ready, click the **Preview** button at the top right. Complete your onboarding flow yourself to ensure everything works as expected.
   
   <img src="/assets/shared/img/create-onboarding4.png"
   style={{
   border: '1px solid #727272', /* border width and color */
   width: '400px', /* image width */
   display: 'block', /* for alignment */
   margin: '0 auto' /* center alignment */
   }}
   />
   
5. If everything works fine, click **Publish** at the top right. Please wait until it is published before getting back to Adapty. Otherwise, your progress will be lost.

:::danger
If you don't click **Publish**, the SDK won't be able to get the onboarding you've created.
:::

   
   <img src="/assets/shared/img/create-onboarding5.png"
   style={{
   border: '1px solid #727272', /* border width and color */
   width: '400px', /* image width */
   display: 'block', /* for alignment */
   margin: '0 auto' /* center alignment */
   }}
   />
   
After your onboarding is published, click **Back to Adapty**. Your onboarding is created, and you can add it to a placement to start using it.

## Step 2. Create a placement for your onboarding

1. Go to **Placements** from the main menu and switch to the **Onboardings** tab. Click **Create placement**.

   
   <img src="/assets/shared/img/create-onboarding6.png"
   style={{
   border: '1px solid #727272', /* border width and color */
   width: '400px', /* image width */
   display: 'block', /* for alignment */
   margin: '0 auto' /* center alignment */
   }}
   />
   

2. Enter the placement name and ID. Then, click **Run onboarding** and select an onboarding to show to all users.
3. If you have a separate onboarding prepared for a specific user group, [add more audiences](audience) and select a different onboarding for them.

## Step 3. Integrate the onboarding into your app

:::important
Onboardings are available for apps using Adapty SDK v3.8.0+ (iOS, Android, React Native, Flutter), v3.14.0+ (Unity), or v3.15.0+ (Kotlin Multiplatform, Capacitor).
:::

To start displaying onboardings in your app, integrate them using Adapty SDK:
- [iOS](ios-onboardings)
- [Android](android-onboardings)
- [React Native](react-native-onboardings)
- [Flutter](flutter-onboardings)
- [Unity](unity-onboardings)
- [Kotlin Multiplatform](kmp-onboardings)
- [Capacitor](capacitor-onboardings)

To understand which onboarding works better, you can also run [A/B tests](ab-tests).