Start tracking your progress
Trailhead Home
Trailhead Home

Promote Feature Adoption and Discovery

Learning Objectives

After completing this unit, you’ll be able to:
  • Decide when to use user engagement prompts.
  • Describe the two types of prompts: floating and docked.
  • Add prompts to your org.

Choosing the Right Subject

Before we get into how to add prompts, let’s talk a little more about why you add prompts. Prompts are perfect for the feature discovery and adoption scenarios, such as:

  • New feature is enabled or available: Experienced users appreciate enhancements to features they use often, and like to be the first to know about new features, as long as the information is helpful and relevant.
  • User isn't taking advantage of a valuable feature: Sometimes your users aren't using your application to its full potential. To help them follow best practices and take advantage of beneficial features, offer tips and guidance focused on saving time and increasing productivity.

How do you choose the right subject for your prompt?

Good Candidates for Prompts Features to Avoid in Prompts
  • Features that are easy to learn and start using right away
  • Features that are available to users without setup or personalization
  • Features that are highly complex
  • Features that have a steep learning curve
  • Features that can be heavily personalized by users

Now that we talked about the goal and purpose of the prompt, let’s chat about the audience. Although every company and user is unique, remember that generally, users:

  • Know the basics, and don’t want their workflow interrupted without good reason
  • Want actionable, relevant information about: new possibilities, updates to features they use often, and new features that could increase productivity
  • Don’t want to be sold to, unless an offering is clearly tailored to their needs

So, unless you want your prompt to be closed before it’s read, carefully select a subject that speaks to your users.

Now that we have our purpose and audience in mind, let’s talk about the two different types of prompts.

Choosing the Right Type of Prompt

Floating prompts are a nonintrusive way to nudge users toward a feature or opportunity. There’s no extra fluff here. Just a short and sweet message and a call to action in the form of a button that opens a URL of your choice. You can place a floating prompt in one of six positions on a page:

  • Top left
  • Top center
  • Top right
  • Bottom left
  • Bottom center
  • Bottom right
Floating prompt wireframe

Floating prompt

Docked prompts are great when users need to refer to content while exploring a feature on their own. Unlike the floating prompt, the docked prompt stays in place while the user navigates through the app. Use a docked prompt for content that you want to remain on screen, such as step-by-step instructions or a short video that users can follow while learning how to complete a task in the app.

Docked prompt wireframe

Docked prompt

Choose a floating prompt when... Choose a docked prompt when...
  • Your goal is to drive readers to a resource, such as a training PDF or website.
  • Your goal is to have readers acknowledge information without specifically completing an action.
  • Your message is short (approximately one sentence).
  • You want to include short, step-by-step instructions that the user can consult while they work.
  • You want to embed a video into the docked prompt.
  • Your message is longer than one sentence.

Examples of Prompts

Here are some examples of the different types of prompts. If you want some other examples of prompts, consider installing the In-App Guidance: Boost Sales User Productivity in Lightning Experience or In-App Guidance: Boost Service User Productivity in Lightning Experience managed package from Salesforce. It’s a great starting point for building your own library of prompts. To install this package, your org must already have the Sales or Service Console app installed.

A floating prompt with a Dismiss button. The text reads: Did You Know? With pinned lists, you can make any list your new default. To pin an unpinned list, click its pin icon.

Suppose you want to introduce users to a new feature for submitting feedback. You draft this message.

How Are We Doing? You have a new way to provide feedback on your workspace. Use the Suggestion Box app to submit suggestions and track their status. No tiny pencils required! To get to the Suggestion Box, go to the App Launcher (it’s the waffle-looking icon in the header) and search for Suggestion Box.

In a docked prompt, your message would look like this.

Docked prompt example

See How Easy It Is to Add a Prompt

Want to Get Hands-on with In-App Guidance?

We don’t have any hands-on challenges in this module, but if you want to follow along and practice the steps, you need to install the Sales or Service version of the In-App Guidance: Boost User Productivity in Lightning Experience package into your Trailhead Playground. To install this package, your org must already have the Sales or Service Console app installed. To launch your playground and install the package, follow these instructions.

First, launch your Trailhead Playground.

  1. Make sure you are logged in to Trailhead.
  2. Then click your user avatar in the upper-right corner of this page, and select Hands-on Orgs from the dropdown.
  3. Then click the username of your org to launch it.

Next, get your username and password.

  1. In your playground, click Setup and select Setup.
  2. Enter Users in the Quick Find box, then select Users.
  3. Check the box next to your name. Make note of your username.
  4. Click Reset Password(s) and then OK. This step sends an email to the address associated with your username. If you don’t see the email, check your spam folder.
  5. Click the link in the email.
  6. Enter a new password and confirm it.

If you’re having trouble finding your username and resetting your password, see this article.

Now you can install the package.

  1. In Chrome, open an incognito browser window.
  2. For prompts for the Sales app, select and copy this link: For prompts for the Service Console app, select and copy this link: In the incognito window, paste the link into the address bar to install the package.
  3. Click Get It Now.
  4. On the Salesforce login screen that appears, enter the username and password for your Trailhead Playground, then click Log In.
  5. Select Install in Production.
  6. Agree to the terms and click Confirm and Install.
  7. On the login screen that appears, log in again with your Trailhead Playground credentials.
  8. Select Install for All Users, then click Install.
  9. Once the installation is complete, click Done.

If you have trouble installing the package, see the Install Apps and Packages in Your Trailhead Playground unit of the Trailhead Playground Management module.

The In-App Guidance: Boost User Productivity in Lightning Experience package that you just installed comes with its own installation and considerations guide.

Let’s take a look at the new prompts you just installed.

  1. Click Setup and select Setup.
  2. In Quick Find, enter in-app, and then select In-App Guidance. You should see the prompts installed from the package listed on the setup page.
  3. Look for the Chatter Profile Tips prompt in the Sales or Service Console app.
  4. From the row-level action dropdown menu, select Preview. A new tab opens allowing you to see how the prompt appears to users.

If these prompts don't precisely meet your needs, you can create your own prompts.

Add a Prompt

Watch this video to see how easy it is to add prompts to your org.

To create your own prompts, follow these steps.

  1. Click Setup and select Setup.
  2. In Quick Find, enter in-app, and then select In-App Guidance.
  3. Click Add Prompt. The Add Prompt window opens.
  4. Click Open Authoring Bar.
  5. Navigate to the app and page where you want to add the prompt.
  6. In the authoring bar, click Add Prompt, and follow the on-screen authoring steps.
  7. When you’re finished, click Save & Preview.
  8. If you want to make changes, click Edit in the authoring bar.
  9. When you’re satisfied with your prompt, click Done.

When you have a lineup of great prompts, it’s important to monitor user engagement to see if your content is actually engaging users. Salesforce has made it easy with prebuilt metrics for prompts.

When a prompt is active, view usage metrics on the In-App Guidance Setup page. Views represent the total number of unique users who have seen the prompt. Completes represent the percentage of viewers who have clicked the action button.

Set up a custom report type using the PromptAction object. Start by adding the LastDisplayDate, LastResult, Name, TimesActionTaken, TimesDismissed, TimesDisplayed, and UserID fields. See the PromptAction API object (in the Resources section) for a list of all the available fields.

Then start asking questions to identify trends. Did you get more views or clicks on docked prompts or floating prompts? Did you get more action button clicks with a certain button label or title? Did longer content get fewer button clicks? Was there a drop-off in engagement during the run of the prompt?

It may be difficult to identify exact correlations between behavior and retention, but reviewing metrics will help you to fine-tune your location, position, content, and frequency settings.

Keep it going! Prompts are pretty easy (and fun) to create. You might want to just keep making more of them. However, prompts are only one part of user engagement. In the next unit, you learn about the troubleshooting scenario and the Help Menu.