---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/reference/ydb-cli/topic-consumer-drop.md
  - https://ydb.tech/docs/ru/reference/ydb-cli/topic-consumer-drop.md
  - href: en/reference/ydb-cli/topic-consumer-drop.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/core/reference/ydb-cli/topic-consumer-drop.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/en/llms.txt

# Deleting a topic consumer

You can use the `topic consumer drop` command to delete a [previously added](https://ydb.tech/docs/en/reference/ydb-cli/topic-consumer-add.md) consumer.

General format of the command:

```bash
ydb [global options...] topic consumer drop <topic-path>
```

* `global options`: [Global parameters](https://ydb.tech/docs/en/reference/ydb-cli/commands/global-options.md).
* `topic-path`: Topic path.

View the description of the delete consumer command:

```bash
ydb topic consumer drop --help
```

## Parameters of the subcommand {#options}

| Name             | Description                         |
|------------------|-------------------------------------|
| `--consumer VAL` | Name of the consumer to be deleted. |

## Examples {#examples}

<!-- source: en/_includes/ydb-cli-profile.md -->
{% note info %}

The examples use the `quickstart` profile. To learn more, see [Creating a profile to connect to a test database](https://ydb.tech/docs/en/reference/ydb-cli/profile/create.md#quickstart).

{% endnote %}
<!-- endsource: en/_includes/ydb-cli-profile.md -->

Delete the [previously created](https://ydb.tech/docs/en/reference/ydb-cli/topic-consumer-add.md) consumer with the `my-consumer` name for the `my-topic` topic:

```bash
ydb -p quickstart topic consumer drop \
  --consumer my-consumer \
  my-topic
```