I want my web application to be self-explanatory. There are input fields and whole pages which need some paragraphs of explanation. How to integrate these user guides to my application? How to make them visible and not disturbing?


4 Answers 4


I would consider revealing the help gradually:

If you set a standard where each field has a tooltip, you can avoid any special icon - the user will immediately know mouse over will result in a tooltip.

Each tooltip should have a link in it (or alternatively the whole tooltip is press-able) to expand it for a more in depth explanation. This explanation can simply open in place or on another page).

  • I like it when the content in the tooltip comes from the general support website. Assuming you have a support website and you use a CMS. Set your support pages in your CMS have a "short help" and "long help" sections. The tool tip shows the "short help" and if there is "long help" it adds a "More" link in the tool tip. This way you only need to update your support pages and the changes are seen in the tooltips.
    – idophir
    Aug 11, 2010 at 13:44
  • 2
    Make sure to attach the tooltip to the onfocus event too. Help shouldn't be served for mouse-interacting users only.
    – jensgram
    Aug 29, 2010 at 11:55

I find the Twitter signup page to do a pretty good job at this:

alt text

They even use this for validation / feedback:

alt text

It does require a few hundred pixels next to your input field, though. It does, however, leave you the freedom to just provide a short help text followed by a "more..." link.


We took the approach that 1st time vistors to our site (making use of cookies) get an alert bar (similar to if you visit SE for the first time) pointing them to the web-help, and a video on how to use the site.

This alert bar would not show up for subsequent visits and thus avoid distracting the user again.
(More info on this blog post.)

For our site, we preferred the non-modal alert bar approach.
However, another approach we were looking at, is a modal alert box on 1st visit, and this would pop up every time, until they clicked the 'Do not show again' tickbox before clicking OK.


You can write up a small explanation in the sidebar the like they do in the SO login page.

another option is to put little icons next to the fields and include a hovering tool-tip next to each field.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.