Field help text
Add optional tooltip or under-title help for calculator input fields, with Design styling and translations.
Written By Floris de Vries
Last updated About 4 hours ago
Field help text
You can add optional help text to input fields so customers understand what to enter. Help can appear as a tooltip next to the label, or as text under the title.
Help text is available on input fields such as text, number, dropdown, radio, checkbox, swatch, color, font, date, file, and calculation display. It is not available on Rich Text blocks or Dividers.
Where to set it
- Open a calculator → Step 1: Form fields.
- Select an input field.
- Find the Help text editor (below the label / placeholder).
- Enter content with limited formatting: bold, italic, lists, and links.
- Choose Tooltip or Under the title.
- Leave the editor empty to hide help on the storefront.
Design (tooltip look)
In Step 3: Design → Help / tooltip you can set (global for the calculator):
- Tooltip icon (? or i)
- Icon color
- Tooltip background color
- Tooltip text color
“Under the title” help follows the normal form text color.
Translations
When a field has help content, Translations includes a multiline key for that help (for example field_width_help). Empty translations fall back to the default language copy from the builder.
Tips
- Keep help short; use links for longer guides.
- Prefer tooltips for brief hints; use under-title for multi-step instructions.
- Test on mobile — tooltips open on tap as well as hover.
Was this helpful?
More in Form Fields
Text FieldNumber InputDropdownRadio ButtonsStill need help? Ask the team