esc
  • WorkflowsPages
  • Case studiesPages
  • Machine Learning FoundationsLearn
  • AI EngineeringLearn
  • AI Guardrails & Red TeamingLearn
  • UI/UXLearn
  • Design SystemsLearn
  • Production System DesignLearn
  • Book a callContact
  • Download ResumeContact
Let’s talk

I’ll build the agent for it.

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. 1

    Find the moment

    Pick the step where users are most likely to get stuck. Show the tip there, not on launch.

  2. 2

    Keep it close

    Place the tip next to the control it explains.

  3. 3

    Make it easy to close

    The user should dismiss the tip with one simple action.

  4. 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. 1

    Is the tip needed?

    If users would not miss it, do not add it.

  2. 2

    Is key information on the page?

    Required facts must not live only in a tip.

  3. 3

    Does it work with a keyboard?

    Test it with focus, not only with the mouse.

  4. 4

    Is it short?

    Remove repeated words and full paragraphs.

  5. 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.

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

How is this lesson?

Last updated on 17 November 2026

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.