Source: https://nishanth-fern-test.docs-staging.pageloop.ai/mobile/walkthrough-best-practics

# Walkthrough Best Practics

Expand the following accordions for more details:

**Use Walkthroughs for product tours and tutorials**

Use Walkthroughs for sequential actions such as, product tours, tutorials, and UI guidance.

![](/images/83/Walkthrough-example-8352c446.png)

**Use the Walkthrough Checklist for user training and onboarding**

Walkthrough Checklist can be used to ensure that your end users can perform all basic tasks. For example, use a Walkthrough Checklist to design an onboarding list of tasks for someone new to your app.

![](/images/46/Mobile_Walkthrough_Checklist-46382426.png)

**Use simple and descriptive titles for Walkthroughs**

Name every Walkthrough clearly so it can be found easily in search results. Use simple and descriptive words that your audience is likely to use. Keep the title short and avoid gerunds.

![image.png](/images/f4/image-98-f452601f.png)

**Use a brief description in Tooltips**

Use easy-to-understand words and simple sentences. Keep the tooltip descriptions concise and to the point.

![Mobile\_bp\_keep description short.png](/images/a8/Mobile_bp_keep-description-short-1-a8d12eaf.png)

**Use Dismissible Icon to start a Walkthrough or Walkthrough Checklist**

Configure a [Dismissible Icon](/mobile/use-icons-to-start-a-walkthrough) to appear on the app screen to enable your end users to start Walkthrough, Walkthrough Menu, or Walkthrough Checklist whenever they want.

![dismissible\_icon](/images/6d/dismissible_icon-6d69132b.png)

**Create Walkthroughs in a stable environment**

Create Walkthroughs on production apps that are stable and not undergoing frequent code changes. If the underlying code of your app is changed, might affect existing Walkthroughs. that you might have created.

![mobile\_bp\_stable site.png](/images/da/mobile_bp_stable-site-da8bc0a1.png)

**Limit the number of steps to 5**

Limit the number of steps in a Whatfix Walkthrough to no more than 5 steps. It helps your users understand the value proposition of your guides quickly and easily.

**Set Discovery Trigger and Flow Termination Conditions**

Configure [Discovery Trigger](/mobile/use-the-discovery-trigger-in-walkthrough) rules to start the Walkthrough based on different criteria. Also configure [Flow Termination](/mobile/flow-termination-to-dismiss-the-walkthrough) conditions to dismiss the Walkthrough from the app screen.

![discovery\_trigger\_event](/images/7d/discovery_trigger_event-7dd187fa.png)

**Ensure that your Tooltips don't hide any UI elements on the screen**

Position the Tooltips so that they don't hide any elements on your app screen. In certain cases, the Tooltip could inadvertently hide certain important UI.

![Mobile\_bp\_do not hide ui.png](/images/0c/Mobile_bp_do-not-hide-ui-0c69ff4c.png)

**Use Optional Step to ensure Walkthrough continuity**

When you have a field or element in an app that does not appear to a certain set of users, configure such steps as Optional to ensure the continuity of the Walkthrough.

If the field or element does not appear, the [Optional steps](/mobile/define-a-step-as-optional) are skipped, and the Walkthrough continues to the next step. If the field or element is present in the UI, then the Walkthrough progresses as usual. You do not have to create a separate Walkthrough and trigger it based on the appearance of the field or element. ![mobile make step optional.png](/images/dd/mobile-make-step-optional-dd53e096.png)

**Author clear and concise content**

Use simple words and sentences while creating Whatfix content. Keep the description in your Tooltip brief and to the point. ![Mobile\_bp\_keep description short.png](/images/a8/Mobile_bp_keep-description-short-1-a8d12eaf.png)

**Choose an appropriate theme for the Tooltip**

Choose the best available Tooltip theme to ensure that the design of the Tooltip matches your app's UI. Use contrasting colors that make the Tooltip noticeable on your app. This is to ensure that the Tooltips are not lost in your interface because they can't be distinguished from the underlying app. ![Mobile\_bp\_consistent theme.png](/images/49/Mobile_bp_consistent-theme-494f6659.png)

**Speak to your end users**

Users who are new to the mobile ecosystem follow audiovisual guidance better. Provide a natural experience using audiovisual guides. For more information, see [Add or generate Audio for your in-app experience](/mobile/how-to-add-or-generate-audio-for-my-in-app-experience). ![mobile\_add audio\_audio](/images/45/mobile_add-audio_audio-45634719.png)
