# vercel rolling-release

The `vercel rolling-release` command (also available as `vercel rr`) is used to manage your project's rolling releases. [Rolling releases](/docs/rolling-releases) allow you to gradually roll out new deployments to a small fraction of your users before promoting them to everyone.

## Usage

```bash filename="terminal"
vercel rolling-release [command]
```

## Commands

### configure

Configure rolling release settings for a project.

```bash filename="terminal"
vercel rolling-release configure --cfg='{"enabled":true, "advancementType":"manual-approval", "stages":[{"targetPercentage":10},{"targetPercentage":50},{"targetPercentage":100}]}'
```

### start

Start a rolling release for a specific deployment.

```bash filename="terminal"
vercel rolling-release start --dpl=dpl_abc
```

**Options:**

| Option  | Type    | Required | Description                        |
| ------- | ------- | -------- | ---------------------------------- |
| `--dpl` | String  | Yes      | The deployment ID or URL to target |
| `--yes` | Boolean | No       | Skip confirmation prompt           |

**Examples:**

```bash filename="terminal"
vercel rr start --dpl=dpl_123abc456def
vercel rr start --dpl=https://my-project-abc123.vercel.app
vercel rr start --dpl=dpl_123 --yes
```

### approve

Approve the current stage of an active rolling release.

```bash filename="terminal"
vercel rolling-release approve --dpl=dpl_abc --currentStageIndex=0
```

### abort

Abort an active rolling release.

```bash filename="terminal"
vercel rolling-release abort --dpl=dpl_abc
```

### complete

Complete an active rolling release, promoting the deployment to 100% of traffic.

```bash filename="terminal"
vercel rolling-release complete --dpl=dpl_abc
```

### fetch

Fetch details about a rolling release.

```bash filename="terminal"
vercel rolling-release fetch
```

## Unique Options

These are options that only apply to the `vercel rolling-release` command.

### Configuration

The `--cfg` option is used to configure rolling release settings. It accepts a JSON string or the value `'disable'` to turn off rolling releases.

```bash filename="terminal"
vercel rolling-release configure --cfg='{"enabled":true, "advancementType":"automatic", "stages":[{"targetPercentage":10,"duration":5},{"targetPercentage":100}]}'
```

### Deployment

The `--dpl` option specifies the deployment ID or URL for rolling release operations.

```bash filename="terminal"
vercel rolling-release start --dpl=https://example.vercel.app
```

### Current Stage Index

The `--currentStageIndex` option specifies the current stage index when approving a rolling release stage.

```bash filename="terminal"
vercel rolling-release approve --currentStageIndex=0 --dpl=dpl_123
```

## Examples

### Configure a rolling release with automatic advancement

```bash filename="terminal"
vercel rolling-release configure --cfg='{"enabled":true, "advancementType":"automatic", "stages":[{"targetPercentage":10,"duration":5},{"targetPercentage":100}]}'
```

This configures a rolling release that starts at 10% traffic, automatically advances after 5 minutes, and then goes to 100%.

### Configure a rolling release with manual approval

```bash filename="terminal"
vercel rolling-release configure --cfg='{"enabled":true, "advancementType":"manual-approval","stages":[{"targetPercentage":10},{"targetPercentage":100}]}'
```

This configures a rolling release that starts at 10% traffic and requires manual approval to advance to 100%.

### Configure a multi-stage rolling release

```bash filename="terminal"
vercel rolling-release configure --cfg='{"enabled":true, "advancementType":"manual-approval", "stages":[{"targetPercentage":10},{"targetPercentage":50},{"targetPercentage":100}]}'
```

This configures a rolling release with three stages: 10%, 50%, and 100% traffic, each requiring manual approval.

### Disable rolling releases

```bash filename="terminal"
vercel rolling-release configure --cfg='disable'
```

This disables rolling releases for the project.


--------------------------------------------------------------------------------
title: "vercel switch"
description: "Learn how to switch between different team scopes using the vercel switch CLI command."
last_updated: "2026-02-03T02:58:38.536Z"
source: "https://vercel.com/docs/cli/switch"
--------------------------------------------------------------------------------