---
title: "The CLI purge contacts command"
slug: "the-cli-purge-contacts-command"
abstract: "Reference of the xConnect DevEx CLI purge contacts command that registers purge tasks."
---
# The CLI purge contacts command

The [xConnect DevEx CLI plugin](https://doc.sitecore.com/xp/en/developers/101/sitecore-experience-platform/xconnect-devex-cli-plugin.html "xConnect DevEx CLI plugin") includes a `purge` command with a `contacts` subcommand. This command initiates a purge process based on the provided `CutoffDays` and conditions.

<details>
<summary><h2>Usage</h2></summary>

You can use the command as follows:

```text
sitecore xconnect purge contacts [subcommand] [options]

```

</details>

<details>
<summary><h2>Subcommands</h2></summary>

You can use the following subcommands:

| Subcommand | Description |
| --- | --- |
| `start` | Register a purge contacts task. |

</details>

<details>
<summary><h2>Options</h2></summary>

You can use the following options with the command:

| Option | Required? | Description |
| --- | --- | --- |
| `-c, --config` | Yes | The path to the `sitecore.json` configuration file (default: cwd). A DevEx CLI standard option. |
| `-n, --environment-name` | Yes | The Sitecore environment to use. Default: `default`. A DevEx CLI standard option. |
| `-d, --cutoffdays` | Yes | The number of days the contact has not interacted with the brand. For example, `-d 190`.<br><br>> [!note]<br>> This option is the only requirement with no default value.<br><br>There is a list of restrictions for the `cutoffdays` option:<br><br><ul><li>The minimum available value is 180 days by default (see [Configure the Cortex Processing Engine for task registration](https://doc.sitecore.com/xp/en/developers/104/sitecore-experience-platform/configure-the-cortex-processing-engine-for-task-registration.html)).</li><li>The value must be a positive integer.</li></ul> |
| `--sp, --start-percentile` | No | The range-bound start percentile for the data extraction. For example, `--sp 0`.<br><br>There is a list of restrictions for the `start-percentile` option:<br><br><ul><li>You must specify both the start and end percentile or none of them.</li><li>The range-bound for both is between 0 and 1.</li><li>The `start-percentile` must be lower than the `end-percentile`.</li></ul> |
| `--ep, --end-percentile` | No | The range-bound end percentile for data extraction. For example, `--ep 1`.<br><br>There is a list of restrictions for the `end-percentile` option:<br><br><ul><li>You must specify both the start and end percentile or none of them.</li><li>The range-bound for both is between 0 and 1.</li><li>The `end-percentile` must be higher than the `start-percentile`.</li></ul> |
| `--cds, --conditions` | No | A comma-separated list of additional filter conditions for a contacts purge. Conditions can be customized and registered for further data filtering. For example, `--cds AnonymousCondition`.<br><br>The task registration fails if a non-existing condition is specified. A list of unfound conditions is in the CLI output.<br><br>> [!note]<br>> See [Walkthrough: Customizing contact purge conditions](https://doc.sitecore.com/xp/en/developers/101/sitecore-experience-platform/walkthrough--customizing-contact-purge-conditions.html) for more details about limits and how to create custom conditions. |
| `-b, --batch-size` | Yes | The batch size for contact data extraction the purge task uses. For example, `-b 200`. |
| `-v, --verbose` | No | Report additional diagnostic and performance data. |
| `-t, --trace` | No | Report additional diagnostic and performance data. |
| `--confirm` | No | Confirm all prompts automatically. |
| `-?, -h, --help` | No | Help for the command. |

</details>

## Examples

The following are examples of the `purge contacts` command use:

```

sitecore xconnect purge contacts start -d 180

sitecore xconnect purge contacts start -d 180 --sp 0 --ep 1 -b 200 --cds AnonymousCondition --trace --verbose

```

<details>
<summary><h2>Confirm or cancel task registration</h2></summary>

The `purge contacts start` command sends a confirmation to the end-user that this command causes data deletion.

The user can confirm task registration by entering `Y` or `y`:

A successful task registration returns a task ID that you can keep for further actions, such as getting the task [status](https://doc.sitecore.com/xp/en/developers/101/sitecore-experience-platform/the-cli-purge-status-command.html "The CLI purge status command") or [canceling](https://doc.sitecore.com/xp/en/developers/101/sitecore-experience-platform/the-cli-purge-cancel-command.html "The CLI purge cancel command") the task.

The user can also cancel the task registration with `N` or `n`. Any other character entries lead to the cancellation of the task registration with a corresponding notification that the confirmation response was invalid.

You may use option `--confirm` for silent confirmation of the task registration. In that case, you do not receive any prompts.

The result of the successful task registration is the task ID and sample commands for canceling and getting the status of the purge task.

</details>