Migration of Tooltip from v5.x to 6.x

February 2, 2026 · View on GitHub

Breaking change: Changed prop types

The Tooltip component introduces one change:

  • placement no longer accepts "auto-start" and "auto-end"

Summary of changes

PropOld TypeNew TypeDefault (Old → New)Status
childrenReact.ReactNodeReact.ReactNoden/aUnchanged
contentReactElement | stringReactElement | stringundefined → undefinedUnchanged
labelstringstringundefined → undefinedUnchanged
asReact.ElementTypeReact.ElementType'span' → 'span'Unchanged
idstringstringundefined → undefinedUnchanged
isVisiblebooleanbooleanfalse → falseUnchanged
maxWidthnumber | CSS.Property.MaxWidthnumber | CSS.Property.MaxWidth360 → 360Unchanged
hideDelaynumbernumber0 → 0Unchanged
showDelaynumbernumber375 → 375Unchanged
placement"auto", "left", "right", "top", "bottom", "auto-start", "auto-end", "top-start", "top-end", "bottom-start", "bottom-end", "right-start", "right-end", "left-start""auto", "top", "right", "bottom", "left", "bottom-start", "bottom-end", "left-start", "left-end","right-start", "right-end", "top-start", "top-end"undefined → undefinedChanged "auto-start" and "auto-end" have been removed, as auto-adjustment for "top", "right", "bottom", "left" is already applied
targetWrapperClassNamestringstringundefined → undefinedUnchanged
usePortalbooleanbooleanfalse → falseUnchanged
isDisabledbooleanbooleanfalse → falseUnchanged
onBlur(evt: FocusEvent) => void(evt: FocusEvent) => voidundefined → undefinedUnchanged
onFocus(evt: FocusEvent) => void(evt: FocusEvent) => voidundefined → undefinedUnchanged
onMouseLeave(evt: MouseEvent) => void(evt: MouseEvent) => voidundefined → undefinedUnchanged
onMouseOver(evt: MouseEvent) => void(evt: MouseEvent) => voidundefined → undefinedUnchanged
onKeyDown(evt: KeyboardEvent) => void(evt: KeyboardEvent) => voidundefined → undefinedUnchanged

Proptery placement migration

OLD: auto-start or auto-end are no longer supported. Auto-adjustment for "top", "right", "bottom", "left" is already applied, so either can be used.

placement = 'auto-start';

NEW:

placement = 'left-start';

Use when you prefer automatic best-fit without manually managing flipping logic.


Migration steps checklist

  1. Replace auto-start and auto-end with any of the other placements or adopt placement="auto".
  2. Re-test behavior