---
url: https://listr2.kilic.dev/task/title.md
---

# {{ $frontmatter.title }}

*Task* can have a title to stand out from the crowd and give the user visual queues of what is actually running.

## Usage

The title of the *Task* can be initiated while creating the task itself and, can be directly manipulated through the injected `task` object during runtime.

This allows the user to change the title depending on the progress made throughout the task, or simply to inform the user that the task is finished.

<<< @../../examples/docs/task/title/task-title.ts{5,9,13}

## Tasks without a Title

The title of a *Task* is an optional property.

For most of the renderers, except for *TestRenderer*, the tasks that do not have a title would be hidden. For something like a default renderer tasks that have subtasks with no title will be flattened visually.

You can always use `task.title` programmatically to add titles, and visually pop tasks to existence.

::: details  Code Example

<<< @../../examples/docs/task/title/task-title-pop.ts{8,12,19,23}

:::