Tooltips are a useful way to highlight additional information for a feature or element in the platform. Use them sparingly and keep these rules in mind:
Tooltips should never stop a user (or be a gate) from completing a task or performing an action. They disappear so they should never contain critical information that a user would absolutely need to proceed, or information without which a user may cause errors. If the information is crucial for a user to proceed, consider using a modal or inline notification instead.
Never include any kind of error messages in a tooltip. As tooltips are hidden, a user may not be aware of an error if it exists in the tooltip text.
Good tooltips contain concise and helpful information. Keep it to one or two very short sentences. Don’t use it to duplicate information that already exists on the page. Instead, closely consider its placement and whether the disclosed copy will inform the action the user is about to perform.
As tooltips only surface from a hover, never include links or buttons in the copy. If your tooltip requires either of these, considers putting your content in a popover.
All tooltips copy should be in sentence case i.e. the first letter of the first word is capitalized and everything else is in lower case unless it’s a proper noun or feature name. Always err on the side of minimal punctuation, so leave out full stops and commas where possible.