Display Content based on User Roles
  • 22 Mar 2024
  • 2 Minutes To Read
  • Dark
  • PDF

Display Content based on User Roles

  • Dark
  • PDF

Article summary

Whatfix enables you to show different content to different users with the use of Role tags. For example, an admin user can be shown more and different content when compared to a basic user. This helps in targeting information based on what users can do on your application. Whatfix needs user information from your application to do this and one of the ways that the user's role is passed on to Whatfix is by using a Window Variable. Other ways to distinguish between users are also described in the following sections.

Step 1: Create Tags

Role-specific tags have to be created for each role. For example, if you have 3 different roles (admin, editor, translator) you have to create tags for each role.

Use the following steps to create a role tag:

  1. On the Whatfix Guidance dashboard, click Tags.

  2. Click All tags.

  1. On the top right, click Create Tag.

  2. Enter a name and description for the tag.

  3. Click the Category dropdown menu, and then select Role Tag.

  4. Under Visibility Rules, select the desired criteria. For more information, see Visibility and Display Rules Conditions.

  5. Click Create.

  6. Similarly, follow the above steps to create tags for each role.

Step 2: Associate Tags to content

Once you've created tags for each role, all the Whatfix content has to be associated with a tag. For example, if you want to show a Flow called 'creating leads' to all the users then add admin, editor, and translator tags to the content.

  1. On the Whatfix dashboard, select the content using the checkbox for which you want to add tags.

  2. Click the Tags icon.

  1. In the popup, type the name of the tag and select from the list.

  2. Click Done.


Follow the above step to associate content to each role tags (editor, translator).

Step 3: Create a segment

Creating segments ensures where your end-users see content. A segment is created and configured with the necessary visibility rules so that relevant content is shown to the right role on the right page.

Use the following steps to create a segment:

  1. On the Whatfix Guidance dashboard, click Widgets.

  2. Click All widgets.

  3. Click Create widget.

  1. Select Self Help or Task List.

  2. Enter the Widget Name.
    SH name.png

  3. Click Add Content.

  4. Click Select by Tags.

  5. Enter the tag name, and then click Okay.


All the content associated with the tag is added.

  1. Under the Visibility section, select Role Tags.
  2. Select Exists and then select the tag (admin).
  3. Add more Visibility Rules as needed.
  4. Click Save.
    Self Help_save.png

You need to create new segments for each role.

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.