Top
Flow Best Practices
  • 25 Jan 2024
  • 2 Minutes To Read
  • Dark
    Light
  • PDF

Flow Best Practices

  • Dark
    Light
  • PDF

Article summary

Use Flows for Product tours and Tutorials

Use Flows for sequential actions. For example: Product tour, Tutorials, and UI guidance.

Use simple descriptive names for Flows

Name every Flow clearly for easy retrieval during search. Use simple descriptive words that your audience is likely to use. Keep the title short. Use gerunds.

Name clearly11

Do not use special characters while naming Flows

Do not use special characters when naming a Flow. Special characters may cause issues when trying to download the Flow as a video.
If the Flow title includes spaces or any of these special characters (<,>,:,",/,|,,?,*,#,%,\s,\n,.), then they are replaced with an underscore (_) when the flow is downloaded as a PDF or a Video.
do not use special char.png

Use a brief description in Tooltips

Use easy to understand words and simple sentences. Keep the description in your tip simple and to the point.
Description simple.png

Create Flows in a stable environment

Create Flow on your desktop application which is stable and is not constantly being updated by code changes. If the underlying code of your application is being changed, it may break any Flows that you may have created.

Stable site 111

Limit the number of steps to 15

Limit the number of steps in a Whatfix guide to not more than 15 steps. This helps your users understand the value proposition of your guides quickly and easily.
Limit to 15 steps2

Split long Flows into two parts

In case you can't keep the number of steps under 15, then consider splitting the guide into two and interlinking them. This keeps your guide crisp and simplifies user tasks.

When interlinking content, ensure that the button on the end message that links to the remaining procedure is titled appropriately. Use a short, action-oriented phrase.

Split into two2

Interlink Flow using a clear phrase

When interlinking content, ensure that the button on the end message that links to the remaining procedure is titled appropriately. Use a short, action-oriented phrase.

Interlink walkthrough using a clear phrase

Make sure Tooltips don't hide any UI elements on the desktop application

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

Remove sensitive information using the Blackout feature

Remove personal/sensitive information using the Blackout feature. While creating a guide, use the Blackout feature to avoid capturing sensitive information like email, phone number, username, and more.
blackout feature2

Use the Spotlight feature to prevent distractions for the user

Use the Spotlight feature to get the user’s complete focus on the element on which the tip is displayed. Users cannot interact with other elements when the Spotlight tip is active.
Spotlight feature11

Don't exceed maximum image width in a Tooltip

When inserting images in your content, ensure that they don't exceed the width of the Tooltip. Exceeding 270 pixels introduces a scroll bar.
distorted image2


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.