Shopware Design

Help Text

Source

Usage

Help Text is a small help trigger that reveals brief supporting guidance in a tooltip. Use it next to a label or control for short explanatory details that are helpful but not essential at first glance, keeping interfaces compact while still offering lightweight guidance.

import { MtHelpText } from "@shopware-ag/meteor-component-library";

API reference

Props

PropTypeDefault
text *string
widthnumber
show-delaynumber0
hide-delaynumber150
placementany

Best practices

Do
  • Use Help Text for brief, supplementary explanations.
  • Place it near the element it describes, such as next to a label.
  • Keep the tooltip text short and specific so users can understand it quickly.
Don't
  • Do not use Help Text for critical information users must always see.
  • Do not put lengthy content in the tooltip.
  • Do not use it as a substitute for a clear label or necessary inline guidance.

Behavior

  • Help Text uses a Tooltip internally and shows the provided text on hover or keyboard focus.
  • placement, width, showDelay, and hideDelay can adjust how the tooltip behaves.
  • The trigger is a small icon button, so the content should stay concise and contextual.

Accessibility

  • Only use Help Text for optional supporting guidance, not for instructions users must read to complete a task.
  • Keep the tooltip text short enough to be understood quickly when focus moves to the trigger.
  • Make sure the nearby label or surrounding UI still makes sense without opening the tooltip.
  • Tooltip: when you need more flexible tooltip behavior or a different trigger element.