---
name: "ctrlSetTooltip"
type: command
status: ok
groups: ["GUI Control"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/ctrlSetTooltip
revid: 379326
updated: 2026-10-30T23:51:38Z
---

# ctrlSetTooltip

*Command · GUI Control · Arma 3 v0.50 · introduced in Armed Assault v1.00*

## Description

Sets tooltip text of given control.

> [!NOTE]
> If control supports URL property, like `RscActiveText` for example, and the URL is set, tooltip text displayed on mouse over will be appended with URL text.

## Syntax

```sqf
control ctrlSetTooltip text
```

**Parameters:**

- `control`: [Control](../topics/Control.md) - any [control type](../topics/Arma~3A_GUI_Configuration.md), (except for CT_STATIC & CT_STRUCTURED_TEXT, although Arma 3 now supports these too)
- `text`: [String](../topics/String.md)

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
_control ctrlSetTooltip "tooltip";
```

### Example 2

```sqf
findDisplay 10000 displayCtrl 10001 ctrlSetTooltip "ThisIsAGoodTip";
```

### Example 3

```sqf
with uiNamespace do
{
    bar = findDisplay 46 createDisplay "RscDisplayEmpty" ctrlCreate ["RscProgress", -1];
    bar ctrlSetPosition [0,0,1,0.01];
    bar ctrlCommit 0;
    bar progressSetPosition 0.75;
    bar ctrlSetTooltip "lalalalalalalala";
};
```

## See also

[ctrlSetTooltipColorBox](../commands/ctrlSetTooltipColorBox.md) · [ctrlSetTooltipColorShade](../commands/ctrlSetTooltipColorShade.md) · [ctrlSetTooltipColorText](../commands/ctrlSetTooltipColorText.md)

## Community notes

**Demellion** — 2017-09-26

**NOTE**: If you want to receive a multi-line tooltip, you can simply input newline escape symbol in your text:

```sqf
_ctrl ctrlSetTooltip "Your text\nYour text on next line";
```

Localization files (stringtable.xml) also supports that.

<sub>Source: [BI Community Wiki — ctrlSetTooltip](https://community.bistudio.com/wiki/ctrlSetTooltip) (revision 379326).</sub>