- 25 Aug 2023
- 4 Minutes To Read
- Print
- DarkLight
- PDF
Create Walkthrough
- Updated On 25 Aug 2023
- 4 Minutes To Read
- Print
- DarkLight
- PDF
Walkthroughs are sequential steps that guide your end users through a process.
You can create and configure your Walkthrough using the following steps:
Step 1: Create a Walkthrough project
Step 2: Connect your mobile app and capture the app screen
Step 3: Identify the screen
Step 4: Design the Walkthrough
Step 1: Create Walkthrough project
On the Whatfix Mobile Dashboard, select the App in which you want to create a Walkthrough project.
To create a new project, click New.
In the Onboarding & Training section, click Walkthrough.
Enter a name for your project.
Enter the App Version or select the App Version using the dropdown.
- Use the latest version of your app to create Whatfix Mobile content. For more information on app version, see What is an App Version?.
- Ensure that you add the correct app version from the app build that was integrated with the Whatfix Mobile SDK.
Click Create.
Your Walkthrough project gets created and you are redirected to the Whatfix Mobile Studio.
- To start creating your Walkthrough, click Add Flow Start.
Step 2: Connect your mobile app and capture the app screen
Use the New Screen Capture experience to simplify your app screen capture process. This is available only for SDK versions equal to or above the following versions:
Android: 1.9.0
iOS: 1.9.0
React Native (Android and iOS): 1.9.0
Xamarin (iOS): 1.6.0
Xamarin (Android): 1.6.2
Cordova (Android and iOS): 1.6.0
Capacitor: 1.4.0
For more information, see Capture app screens using New Screen Capture Experience.
You need to connect your mobile app to the Whatfix Mobile Studio before you can start creating your in-app experience. This can be done by scanning the QR code available on the Whatfix Mobile Studio using your mobile app integrated to Whatfix Mobile.
Open your app integrated to Whatfix Mobile on your mobile phone and then enable the Creator mode.
Navigate to the Whatfix Mobile Studio on your browser and scan the QR code using your mobile app.
- You can see the notification on your phone that your app is connected to the Walkthrough project.
- You can navigate to any screen on your mobile app on which you want to create your Walkthrough.
- To capture the screen on which you want to create your Walkthrough, click Capture.
Step 3: Identify the screen
After capturing the screen, you need to identify the unique elements on the screen and tag the screen so that the in-app experience you create appears on the right page.
To identify the unique elements on the screen and to tag the right screen, click Add Identifier
Click the desired element on the page.
Example: If you want to start the Walkthrough on the Home screen, you can choose the title Home, which can uniquely identify the screen and show the element on the correct screen.
Click Add More to select more elements on the page, and then repeat step 2.
Step 4: Design the Walkthrough
You need to add a starting point for the Walkthrough from where your end users can start the Walkthrough and then be guided to the subsequent steps.
Use the following steps to design your Walkthrough:
On the Whatfix Mobile Studio, navigate to the left and select Design.
Choose the element you want to add on the starting screen.
You can add a Popup, Bottom Sheet, or a Ping to start the Walkthrough
- If you're adding a Popup, choose the appropriate template.
The Popup template you choose appears on the Studio.
- Design the Popup as required. For more information see, Create a Pop-up.
If you're adding Bottom Sheet, see Customize Bottom Sheet
- You can configure the following options for your Walkthrough:
- Show the Pop-up in the Walkthrough in the language of your choice.
- Auto Start: Enable the AUTO START toggle to start a Walkthrough without showing the start screen and automatically trigger the steps.
- Icon: Enable the ICON toggle to enable your end users to start the Walkthrough using an icon. For more information, see Use Icons to start a Walkthrough.
- Discovery Trigger: Define when the Walkthrough should start using the DISCOVERY TRIGGER, if you haven't enabled the AUTO START toggle. For more information, see Use the Discovery Trigger in Walkthrough.
- Flow Termination: Select how to terminate your Flow using the FLOW TERMINATION dropdown. For more information, see Flow Termination to dismiss the Walkthrough.
- Optional Steps: Define a step as optional by enabling the MARK STEP AS OPTIONAL toggle. For more information, see Define a step as optional.
The Start page of your Walkthrough is automatically saved.
Click the Back icon.
Click the ADD STEP tile.
To create the Walkthrough steps with other elements, connect your app, capture the screen, and identify the screen.
Select the element you want to show and design the element as per your requirement.
You can create a Popup, Tooltip, Fullscreen, Highlight, Bottom Sheet, or Gesture as elements in your Walkthrough step. For more information see,
- To enable your end user to navigate to the next step in the Walkthrough, select the STEP TRANSITION rules using the dropdown. For more information, see Define Step Transition rules.
The element you create is autosaved.
Click the Back icon.
To add more steps in your Walkthrough, repeat Steps 7 to 11.
You can preview projects on a device before making it live for your end users.
After creating and designing the Walkthrough, click Publish to make the Walkthrough live for your end users. For more information on publishing Whatfix Mobile content, see Publish Whatfix Mobile content.