Best Practice: Drive up Salesforce user adoption — in-app help & feedback

Ian Gotts @iangotts
6 min readMay 15, 2020

Business benefits

Poor user adoption is a triple threat:

  • users not using apps, so no data and wasting money on Salesforce licenses
  • users using apps but entering incorrect data leading to poor decision making by humans and Einstein
  • user using apps but wasting time with “field that look like CVS receipts”

Post COVID-19, organizations will be changing quickly to respond to evolving business priorities. Keeping users on the same page is critical, especially when that page could be different tomorrow. No-one has the time or luxury for training courses. All training needs to be point-of-need and self service. It also needs to react quickly — in minutes — to feedback.

The aim is to streamline the user experience so that they:

  • enter the correct information in fields
  • spend as little time as possible
  • understand the implications of what they enter in any field.

And if the experience is poor, they should have an easy mechanism to give feedback. It must be responded to in real time to build positive reinforcement.

Tools to improve user adoption

There are native Salesforce tools to improve the user’s experience, which are extended by Elements.

Salesforce features

  • Page Layouts and Dynamic Lightning Pages means you can provide role-specific screens and tabs simplifying pages
  • With Field Level Permissions you can hide fields on page layouts for certain roles though Permissions
  • Field Help Text is 255 plain text popup and is available for most (but not all) fields
  • In-App Guidance is screen prompt windows that can be programmed to pop-up when a user enters a screen. These are best useful for notifications rather than process-context help so are not covered in this article

Elements in-app help and feedback features

  • Pop-up help for an object based on record type
  • Pop-up help for all fields
  • End users can rate help
  • Tracking help views and ratings
  • Pop-up feedback for objects and all fields
  • Feedback stored against object and fields
  • Feedback alerts Admin and posts to Chatter feed
  • Feedback can be turned in to requirements

Elements page clean up features

  • Field population by record type
  • Field impact analysis based on field usage and population
  • Field information and analysis displayed in record page for Admins

Clean up pages

APPROACH

You need to reduce the fields on a page layout for any role to an absolute minimum for 3 reasons:

  • Save time & money: 1 min saved on a page that is viewed 5x a day by 100 users = 8 hours saved time
  • Drop in user engagement: Page layouts that look like CVS receipts means the pages load more slowly, especially in Lightning.
  • Kills user morale: Staring at page of 30–100 fields with no understanding of which fields are relevant is a huge turnoff

ACTIONS

Evaluate every field on a page layout from a role type’s perspective and ask:

  • Does this field need to be on the screen for this role?
  • Can we move field to a page layout for this role?
  • Can the field be removed or deleted if it is not used?
  • Can the field be hidden fields using Field level Permissions?
  • Can the field be hidden using Lightning Lightning Dynamic Pages?

RESOURCES

  • Clean up page layout video
  • Viewing Elements field insights in right panel in record page. This is only used by the Salesforce Admin to inspect fields and add help. It is only visible in Classic page view. For every field is shows usage, population by record type and field impact assessment so it is easier decide on help.

Object level help

APPROACH

At an object level users need to know the overall process and how the related objects on the page interact. Salesforce Help Text is not available for objects or record types.

Add Elements in-app pop-up at an Object level — the purple help icon.

If you have multiple record types, separate the help for each Record type so certain help topics only appre for each record type

The are 3 types of help. Always add them in this order for every object / record type:

  1. Business owner. Use an Elements Note to list their name, email and scope so that users understand who to go to to lobby for changes!!
  2. Elements help topics for related objects: Add them in alphabetical order. Naming convention {object name}: {title}
  3. Object level collateral: These could also be linked to steps in the process diagram. THis could be notes, URL links or process diagrams.
  4. Elements process diagram: This shows overall process for the object and related objects. This is really helpful for any process that touches multiple objects, as it is far easier to create than textual document. Link to the 1st process step in the diagram.

Below is the Opportunity object with purple Elements help icon for the object clicked to show the dropdown of help icons. This is available for standard, custom and managed package objects.

ACTIONS

  • Create an Elements process diagram and link to the Record Type or Object
  • Add Elements help topics to the Record Type or Object

RESOURCES

Field level help

APPROACH

Help is to improve data quality and streamline the process, so it needs to be written from the infrequent end user’s perspective. Therefore end user help may be different from Admin documentation, however it could be the same.

  • Every field should have help Elements in-app help so each field gets the feedback icon. If there is no need for help, then question why the field is on the page.
  • Help can be rich text notes, links to external content or process diagrams (these can be help diagrams to show how validation works or how a flow that is kicked off works, rather than operational process diagrams. These diagrams could be in a separate map).
  • Here is some advice on specific field types

Object name field: add a note with naming convention for record. There is no Salesforce help text for the name field, so this will be an Elements note.

Read-only fields: Why are they read only? Are they controlled through quick actions or flows?

Picklists: What does each value mean? How does the end user choose?

Multi-select picklists: How does the end user choose? “facepalm”

Lookup / related fields: How do they easily select the right related record.

Fields with validation rules: Explain how the validation rule works, so the end user can easily enter the correct value.

Fields that kick off automation: Explain the implications of entering data.

Below is the Opportunity object with purple Elements help icon for the field “Order number” clicked to show the dropdown of help icons. This is available for standard, custom and managed package objects.

ACTIONS

  • Edit Salesforce Help text from within Elements or Salesforce Setup
  • Add Elements help topics (notes, URL links, process diagrams)

RESOURCES

  • Viewing Elements field insights and editing Salesforce and Elements Help in the right panel in a record page. This is only used by the Salesforce Admin to inspect fields and add help. It is only visible in Classic page view. For every field it shows usage, population by record type and field impact assessment so it is easier decide on what help to add.

--

--