Four examples of Embedded Help. Do you offer this to your users?

helperIf you have read my article, What IS it that you do?, then you might already know that one of my passions is helping my customers. One of the ways that I do this is by writing embedded help.

Embedded help is user assistance that is integrated into the user interface so that users can get help without interrupting their workflow.

In this article, I describe four types of embedded help that I write.

On-screen

On-screen help is text that remains on the user interface at all times. Use this type of help to describe the type of information that a user can enter in a field, as shown in the example below.

temp1

Another way to describe the type of information that a user can enter in a field is to write the instructions directly in the field.

temp2

You can also use on-screen help to describe an area of the page or to describe one or more fields, like PayPal.

temp3

Tooltip

Tooltip help is shown when a user holds their cursor over an object. Use this type of help to describe the function of the object. The following is an example of how Goodreads.com uses a tooltip.

temp4

Icon

Icon help is shown when the user clicks an icon such as a question mark. Use this type of help to clarify the use of the field or provide information about the values to be entered. In the following example, a user can click the icon to get learn about the field.

temp5

Panel

Panel help is shown when a user clicks a Help link on the page. This type of help offers more extensive information about the page or an area of the page, such as workflow or task information. For example, you can describe how to perform a complex task.

So, there you have it – On-screen, Tooltip, Icon, and Panel help. These are the four main types of embedded help that I write.

The output seems so simple! But, rest assured, there is a lot of work that goes into this. I start work on this as early as possible, often when the prototypes are being built, and finish only after the help has been tested in the software and is working as expected.

Do you write embedded help? Tell me about it!

Originally published March 30, 2017

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s