Glossary · Usability & UX

Onboarding hint

In short

An onboarding hint is a short overlay that shows, on the first visit, how to use a 3D model – for example "drag to rotate". Good hints are brief, sit where the action happens and disappear as soon as the user acts.

Why a hint at all

A 3D model often looks like a picture. Many visitors do not realise they can turn it, or do not know how to zoom. A hint closes that gap – as long as it stays small.

A hint, not a tutorial

The Nielsen Norman Group concludes that tutorials interrupt users, do not necessarily improve task performance and are quickly forgotten; contextual help avoids these pitfalls but needs unintrusive ways to activate it [1]. For a configurator that means no multi-page introduction, just one sentence on the model.

Rules for good hints

RuleIn practice
Shortone sentence, one verb: "Drag to rotate"
In placedirectly over the 3D area, not at the top of the page
Self-dismissingon the first rotation or after a few seconds
Device-aware"drag" works for mouse and finger; the zoom hint matches the device
Calmno looping animation; motion is dropped under reduced motion

Under WCAG, moving content that starts automatically and lasts more than five seconds needs a way to pause, stop or hide it [2]. A calm, non-animated hint that disappears after a few seconds avoids the issue altogether.

Example from the library

The chemical store example shows "Drag to rotate · "Load" starts the forklift". The hint disappears on the first rotation or after seven seconds. Example configurator, fictional product.

What a hint cannot fix

If users still fail, the problem usually lies deeper: controls that are too small, a model that blocks page scrolling (see scroll trapping), or no alternative to the gesture (see touch gestures).

Related terms

  • Touch gestures in a 3D viewer

    Touch gestures are the finger movements used to work a 3D model on phones and tablets: drag with one finger to rotate, pinch with two to zoom, tap to select. Every gesture should also have a simple alternative.

  • Progressive disclosure

    Progressive disclosure is a design principle: first show the few decisions most users need, and bring in rare or advanced options only on request. It makes applications easier to learn and less error-prone.

  • Reduced motion (prefers-reduced-motion)

    Reduced motion is a system setting with which users ask for less animation on screen. Websites detect it through the CSS media query prefers-reduced-motion. A 3D configurator should then drop camera flights, inertia and looping animation.

  • Scroll trapping

    Scroll trapping happens when an embedded 3D model captures mouse-wheel or swipe movements for zoom and rotation, so the page can no longer be scrolled over it. On phones, where the model fills the screen, users get stuck.

Examples to try

Example configurator · fictional product

Chemical & hazmat store configurator

Plan a steel chemical store: choose front access or walk-in, modules, storage system and door type, place IBCs and drums – with a live sump readout against an example rule, a fill animation, forklift loading and a PDF enquiry.

Prefab process cells · Dimensions and sizes · Colours · Materials and finishes

More in our guides

Sources

  1. Nielsen Norman Group: Onboarding Tutorials vs. Contextual Help
  2. W3C: Understanding Success Criterion 2.2.2 Pause, Stop, Hide

← All terms in the glossary