---
name: "titleText"
type: command
status: ok
groups: ["GUI Control"]
arma3_since: "0.50"
locality: {"argument": null, "effect": "local", "server_exec": false}
source: https://community.bistudio.com/wiki/titleText
revid: 336846
updated: 2023-01-04T16:43:44Z
---

# titleText

*Command · GUI Control · Arma 3 v0.50 · introduced in Operation Flashpoint v1.00*

Locality: effect **local**

## Description

Displays text across the screen. If used along with [cutText](../commands/cutText.md) two different texts (in different type styles) can be shown at once.
The text can be displayed on multiple lines by using "\n" new line characters (see [#Example 3](../commands/titleText.md#example-3)).

## Syntax

```sqf
titleText [text, type, speed, showInMap, isStructuredText]
```

**Parameters:**

- `text`: [String](../topics/String.md) - text to be displayed
- `type`: [String](../topics/String.md) - one of "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" and "WHITE IN". See Title Effect Types for more information about these values.
- `speed`: [Number](../topics/Number.md) - (Optional, default -1) time in seconds to fade in resource
- `showInMap`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) [false](../commands/false.md) to hide the text when the map is opened
- `isStructuredText`: [Boolean](../topics/Boolean.md) - (Optional, default [false](../commands/false.md)) [true](../commands/true.md) to switch support for [Structured Text](../topics/Structured_Text.md) formatting - see [#Example 4](../commands/titleText.md#example-4) *(since arma3 1.74)*

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

## Examples

### Example 1

```sqf
titleText ["Show this text", "PLAIN"];
```

### Example 2

```sqf
titleText ["Your message", "BLACK", 2];
```

### Example 3

```sqf
titleText ["line1\nline2\nline3", "PLAIN"];
```

### Example 4

```sqf
titleText ["<t color='#ff0000' size='5'>RED ALERT!</t><br/>***********", "PLAIN", -1, true, true];
```

## See also

[titleFadeOut](../commands/titleFadeOut.md) · [cutText](../commands/cutText.md) · [cutObj](../commands/cutObj.md) · [allActiveTitleEffects](../commands/allActiveTitleEffects.md) · [activeTitleEffectParams](../commands/activeTitleEffectParams.md)

## Community notes

**DreadedEntity** — 2014-11-21

The third parameter or 'speed', as it is called in the description, refers to the amount of time the message will be shown on-screen. Multiply each number by 10 to get the number of seconds it will be shown. You can even use floats as input, like 0.1, to show a message for only 1 second.

**Note**: Calculating the time with that method does not include the time it takes to fade in/out, which is about 1 second unless you use numbers lower than 1.

**Note**: Using anything lower than 0.001 seems to have no effect, or the effect is so little it is negligible.

**(A3 1.34.128075)**

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