Balance Logo
Reckon Design System
Open playroom


Tooltips are floating labels that briefly explain the function of a user interface element.
pnpm add @balance-web/tooltip
Import usage
import {
} from '@balance-web/tooltip';
  • Code
  • API

Tooltips are meant to be used for supplemental content and should never be used for critical information the user needs to complete a task. Tooltips may not contain interactive elements (such as buttons or links).


Tooltips should:

  • Provide useful, additional information or clarification.
  • Succinctly describe or expand on the element they point to.
  • Be provided for icon-only buttons or a button with an associated keyboard shortcut.
  • Be used sparingly. Prefer clarifying the design and the language in the experience.


Tooltips are displayed to the user on hover or focus of the target element.

IMPORTANT: Tooltips cannot be applied to icons. Notice that we're wrapping the icon and providing an aria-label, this is required for accessibility.

Edit in Playroom


The placement of the tooltip relative to the target.


To ensure readability, tooltips have a maximum width of 260px, which means that text will wrap onto multiple lines if you provide enough content.

You can also use multiple text elements and layout components to create more custom layouts.

Conditional rendering

A tooltip must always have content.

IMPORTANT: Do not provide an empty string or other falsy data to the tooltip "content" prop. Instead, conditionally render the tooltip itself. This is required for accessibility.

Remember that you can compose Balance components to create your own:

import { TooltipProps, Tooltip } from '@balance-web/tooltip';
type ConditionalTooltipProps = { when: boolean } & TooltipProps;
export const ConditionalTooltip = ({
}: ConditionalTooltipProps) => {
if (when) {
return <Tooltip {...tooltipProps}>{children}</Tooltip>;
return children;

Then use them in your app:

<ConditionalTooltip when={someCondition} content="Tooltip for disabled button">
<Button disabled={someCondition} label="Some label" />
Copyright © 2024 Reckon. Designed and developed in partnership with Thinkmill.
Bitbucket logoJira software logoConfluence logo