> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tooltip

> A UI component that displays additional context on hover or focus, with configurable icon and content.

## Overview

A Tooltip is a thin contextual hint anchored to an icon. Use it to explain a non-obvious field label, surface a regulatory disclaimer next to a control, or expand on an acronym without taking screen space.

The trigger icon comes from the theme, and you can replace it for a single tooltip with **Override icon** in the **Properties** section of the **Styles** tab. The tooltip opens on hover or focus, and the overlay positions itself automatically to stay on screen. On web, keyboard users can tab to the trigger only when the tooltip text contains a link.

Add the Tooltip inside a Container or Card, or inside a Collection's prototype. On a process screen, place it inside a Container or Card.

## Properties

| Property | Type | Description |
| - | - | - |
| **Tooltip text** | Markdown / expression | Tooltip text, edited in the markdown editor. Inline markdown, such as bold, italics, and links, renders in the tooltip. Bind to a process data key for dynamic content, or type static text. New tooltips start with the text `Text`. |
| **Hide** | Expression | In the **Expressions** section, add a **Hide** expression. It appears as **Hide condition**: a JavaScript expression that hides the Tooltip when it evaluates to `true`. |
| **Theme overrides** | Object | Override **Font**, **Text** color, **Background**, **Border** color, **Border width**, **Border radius**, **Max width**, **Max rows**, **Icon** color, or **Shadow** for this instance only. On iOS and Android, only **Font**, **Text**, **Background**, **Border radius**, and **Icon** are available. |
| **Override icon** | SVG | In the **Styles** tab, under **Properties**. Replaces the theme's trigger icon for this tooltip only. |
| **Accessibility label** | String | Label for assistive technologies. Use it when the tooltip has no visible label or text, or needs a different label for screen readers. |
| **Mark as decorative** | Toggle | Marks the tooltip as decorative so assistive technologies ignore it. |

## Process data binding

To drive Tooltip content from process data, bind **Tooltip text** to a process data key:

```javascript theme={"dark"}
${application.help.fieldExplanation}
```

For static content, type the text in **Tooltip text**, for example `Your IBAN is shown as it appears on your **bank statement**.` Inline markdown is supported, including links such as `[fees](https://example.com/fees)`. Images aren't shown: their alt text appears instead.

To show a substitution tag, write `${tag:key}` in **Tooltip text**, for example `${tag:ibanHelp}`. The tag can sit inside other text and next to process data keys.

See [Dynamic and computed values](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/dynamic-and-computed-values.md) for the full expression syntax.

## Theme configuration

Defaults from the platform theme:

| Token | Default | Description |
| - | - | - |
| `paddingTop`, `paddingRight`, `paddingBottom`, `paddingLeft` | `8px` each | Inner padding around the tooltip content. |
| `font` | `typography@Caption#regular` | Body typography. |
| `color` | `color@neutrals#500` | Text colour. |
| `backgroundColor` | `color@shades#100` | Tooltip background. |
| `borderColor` | `color@neutrals#200` | Outline colour. |
| `borderWidth` | `1px` | Outline thickness. |
| `borderRadius` | `8px` | Corner radius. |
| `maxWidth` | `360px` | Maximum overlay width before text wraps. |
| `maxRows` | `5` | Maximum text rows before truncation. |
| `iconColor` | `color@neutrals#500` | Trigger icon colour. |
| `shadow` | `shadow@s` | Drop shadow on the overlay. |
| `tooltipIcon` (icon) | `sys_TooltipInfo_16` | Trigger icon. Replace it in the theme for every tooltip, or per tooltip in the **Styles** tab. |

The table shows the web defaults. On iOS and Android, padding is `16` on each side and the trigger icon is `sys_TooltipInfo_24`. The mobile theme has no `borderColor`, `borderWidth`, `maxWidth`, `maxRows` or `shadow` tokens.

To override globally, edit **Theme → Components → Tooltip** in the Designer.

## Related resources

> [card] [UI Designer overview](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/ui-designer.md)
>
> Compose screens in the UI Designer.

> [card] [Dynamic and computed values](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/dynamic-and-computed-values.md)
>
> Bind tooltip text to process data.


## Related topics

- [Chat component](https://docs.flowx.ai/6.x/ai-platform/chat-component.md)
- [Radio](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/ui-component-types/form-elements/radio-form-field.md)
- [Datepicker](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/ui-component-types/form-elements/datepicker-form-field.md)
- [Text area](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/ui-component-types/form-elements/text-area.md)
- [Multi select](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/ui-component-types/form-elements/multi-select.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.