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

# {{ $frontmatter.title }}

Conditional skip is a way of skipping a *Task* depending on the given context. But the main difference between `enable` and `skip` is `skip` will always render the given task. When the execution time comes, and it turns out that it should be skipped, it will render or mark it as skipped.

::: warning

Please pay attention to asynchronous operation while designing a context-enabled task list since it does not wait for any variable in the context.

:::

::: info Example

You can find the related examples [here](https://github.com/listr2/listr2/tree/master/examples/task-skip.example.ts).

:::

## Usage

Skip call can either have or not have a message, therefore it is optional. Having a message combined with the selected renderer and its settings will yield a different output, where skip message could be directly shown.

## Skip inside a *Task*

<<< @../../examples/docs/task/skip/inside.ts{8}

## Skip conditionally defining the *Task*

<<< @../../examples/docs/task/skip/task.ts{8,14}

## Renderer

### *DefaultRenderer*

The default renderer has options where you can change how the skip messages are displayed.

### *SimpleRenderer* & *VerboseRenderer*

The non-TTY renderers log a `SKIPPED` entry with the skip reason when a task is skipped; the display options above are specific to the *DefaultRenderer*.