Usability heuristic

Contextual help

Guidance that appears inside the real interface at the moment and place a user needs it, rather than up front.

Contextual help The same tip delivered two ways. On the left it is tip 3 of 5 in a welcome tour that the user skips, so later the Workspace name field leaves them asking what goes here. On the right the tip sits as a helper line right under the field. Tip in a welcome tour Welcome tour, tip 3 of 5 Skip Your workspace name is usually your company name. Skipped. Later, at the form: Workspace name ? “What goes here?” Same tip, next to the field Create your workspace Workspace name Create workspace i This is usually your company name Help where and when it is needed People skip manuals and tours and start working (Carroll and Rosson, 1987)
The same tip buried in a welcome tour that gets skipped, and placed as a helper line under the field where the question comes up.

Contextual help puts the explanation next to the thing it explains, at the moment the user reaches it: a coach mark on the actual tab, a helper line under a confusing field, a limit message inside the chat where work just stopped. On this site the label also covers support paths, learning resources linked from empty states, and orientation cues like a "Current plan" tag.

John Carroll and Mary Beth Rosson (1987) described the "paradox of the active user": people skip manuals and start working, even though learning first would save time. Nielsen's heuristic 10 says the best system needs no explanation, and when help is needed it should be tied to the user's task. NN/g's Page Laubheimer distinguishes "push" help (tutorials shown regardless of what you are doing, often skipped and forgotten) from "pull" help triggered by what the user is doing, which works better but requires the product to infer intent.

Onboarding carousels are push help. They delay value and are forgotten by the time the user needs them. Contextual help moves the same content to the step where it matters, which also cuts support tickets.

How to use it

  • Put a one-line helper under any field users are likely to hesitate on ("This is usually your company name").
  • Run tours as coach marks in the real UI, one at a time, each tied to an action the user can take right there.
  • When a limit or error stops the user, explain it where it happened and offer the next step (upgrade, docs link, contact) in the same place.

Watch out

  • Tips that pop up without a trigger, or that can't be dismissed, become interruptions.
  • Explaining obvious controls adds noise; save help for genuinely unfamiliar or high-stakes steps.

Related

Contextual help in real products 21 working · 1 not

Dazzle AI: Tour inside the real UI Dazzle AI (working) Tour inside the real UI The coach mark points at the Ideas tab, so the tour happens in context, not in a carousel. Cursor: Current plan labeled Cursor (working) Current plan labeled The "Current" tag on Pro shows where you stand before you compare. Cursor: At the moment of need Cursor (working) At the moment of need "You've hit your usage limit" appears inside the chat, where the work just stopped. Buffer: Content as the nudge Buffer (working) Content as the nudge The link to "How to Use Hashtags" turns a non-used feature into a reason to try it. Gamma: Prompt asks for what works Gamma (working) Prompt asks for what works "What works really well for you?" invites specific praise you can reuse in marketing. Databricks: Helper under the field Databricks (working) Helper under the field "This is usually your company name" answers the obvious question before it is asked. Count: Instructions beside the form Count (working) Instructions beside the form Option a) and b) explain each button, with links to docs and "speak to one of the team". Peliqan: Where to get the key Peliqan (working) Where to get the key The info panel gives the Google Cloud IAM path to create and download a JSON key. Peliqan: Format example Peliqan (working) Format example "For example us-central1" shows the expected value under the field. Peliqan: Explains the defaults Peliqan (working) Explains the defaults The panel says Peliqan uses the user's default warehouse and gives the account-name format "xx12345.eu-central-1". Supabase: Self-serve first Supabase (working) Self-serve first Troubleshooting, Docs and Status come before any contact option. Linear: Tab you just opened Linear (working) Tab you just opened The tip appears when you open "Active", so it explains the view in front of you. Lightdash: Support on the blocker Lightdash (working) Support on the blocker "Chat to support here" sits on the page that gates access. Lightdash: Docs one click away Lightdash (working) Docs one click away "View docs" under the choices for anyone unsure. Count: Getting started cards Count (working) Getting started cards Four videos from "What is the Count canvas?" to use cases. Count: Help always there Count (working) Help always there A floating "?" in the corner of every screen. Count: Self-serve first Count (working) Self-serve first Help, FAQ, canvas examples and docs come before people. Count: People second Count (working) People second Slack community and live chat below a divider. Count: A clear promise Count (working) A clear promise "Videos designed to take you from zero to Canvas hero." Holistics: Help where you need it Holistics (working) Help where you need it IP addresses to whitelist are listed beside the form, not in a doc. Holistics: Concept explained inline Holistics (working) Concept explained inline Tooltip: edit files "without affecting what your end-users are using". Peliqan: Host with no hint Peliqan (not working) Host with no hint No example of the host format and nothing about IP allowlisting, the usual reason a Postgres connection fails.