How-to Tips: Help People Learn Without Getting in the Way
Short, timely tips help people use a screen. Show them at the right moment, keep them brief, and never hide vital facts in them.
In short
How-to tips are short, timely hints that help people use a screen. Show them at the right moment, keep them brief, and never hide vital facts in them.
5 min readFree
What you will learn
A how-to tip teaches a person how to use a screen. It might be a small hint, a short note, or a guided walkthrough. This lesson shows when each kind helps and when it gets in the way. The advice comes from guidelines by the Nielsen Norman Group and Google's Material Design team.
Key words
- Tip
- A short piece of help shown near the thing it explains.
- Tooltip
- A small text label that appears when a user points at an element, or when a keyboard user keeps focus on it.
- Onboarding
- Getting users familiar with a new interface, including setup.
- Contextual help
- Help shown while the user works on a task, not on its own.
- Microcontent
- Very short text, often a few words or one line.
- Push revelation
- Help shown with no clear reason, such as a pop-up when an app opens.
- Pull revelation
- Help shown because the user is doing something that needs it.
What are tooltips?
A tooltip is a brief message. It appears when a user moves the mouse over an element, such as an icon. Keyboard users can also see it by keeping focus on that element for a while. It explains one element, not the whole task.
Use them for unclear icons
An icon with no words is the best case for a tooltip. If the label already says what it does, skip the tooltip.
Skip the obvious
A tooltip that repeats a button's label only adds clutter. If you cannot write a useful tip, leave it out.
Work for keyboard users too
A tooltip that opens only on mouse hover is missed by keyboard users. Let it open on keyboard focus too.
How short should tooltip words be?
Tooltip text is microcontent: a few words that make sense on their own.
Tip
Before you add a tip, ask: would a new user learn something real from it? If not, delete it.
Why keep vital facts on the screen?
A tooltip disappears when the pointer moves away. So never put information a user needs to finish a task inside one. Password rules are a good example. Show them on the page while the user types.
Quick check
Where should the rules for a new password go?
When should you teach?
Help works best at the moment of need. Push revelations appear with no reason, such as a tour when an app opens. Pull revelations appear because the user is doing a task that needs them. The Nielsen Norman Group reports that tutorials are often skipped and quickly forgotten. Contextual tips avoid this problem, if they are easy to trigger without being pushy.
Push help
Shown at random or at launch. It often interrupts people who are busy with something else.
Pull help
Shown when the user reaches the step it explains. It is more likely to be read and used.
Overlays
Highlights on top of the screen.
How do you build a pull tip?
- 1
Find the moment
Pick the step where users are most likely to get stuck. Show the tip there, not on launch.
- 2
Keep it close
Place the tip next to the control it explains.
- 3
Make it easy to close
The user should dismiss the tip with one simple action.
- 4
Make it easy to find again
Give users a way to bring the help back later, such as a Help menu entry.
Why fix the design before you add a tip?
A tip should not patch a poor screen. If users need a long guide to find the main button, make the button clearer. The Nielsen Norman Group advises against using onboarding to cover poor design. It says onboarding is unnecessary for most apps and should be avoided where possible.
Fix first
If many people ask how a control works, change the control.
Trust common rules
The label 'Settings' is generally recognized, so a clear label needs no extra tip.
Name the outcome
Command labels should describe the result.
A quick check before you ship
- 1
Is the tip needed?
If users would not miss it, do not add it.
- 2
Is key information on the page?
Required facts must not live only in a tip.
- 3
Does it work with a keyboard?
Test it with focus, not only with the mouse.
- 4
Is it short?
Remove repeated words and full paragraphs.
- 5
Can users close it and find it again?
Both should be possible.
Count the words in a tip
A small script can help a team spot long tips. This one uses only built-in Python.
tips = ["Save", "Save your work to the cloud"]
for tip in tips:
print(len(tip.split()), tip)Output
1 Save 6 Save your work to the cloud
Long tips are a warning sign. Shorten them, or move the content onto the page where people can see it.
Check your understanding
Quick check
A new user opens an app for the first time. Which help fits best?
Sources
Last updated on 17 November 2026
Related lessons
Learn with me
Every lesson is free. I add new ones as I learn. Have a question, or want help with your own work? Book a short call.