---
category: general
scraped_at: '2025-11-12T14:10:10.012185'
title: Replay
url: /docs/replay
---
# Replay
## Replay command
The `replay` command allows you to replay previously recorded conversations with your Voiceflow project. This is useful for testing changes to your project with consistent inputs, demonstrating flows, or debugging issues.
## Usage
Bash
```
voiceflow dialog replay -f RECORD_FILE [options]
```
## Options
| Option | Shorthand | Description |
| --- | --- | --- |
| `--record-file` | `-f` | Path to the recorded conversation file (required) |
| `--environment` | `-e` | Environment to use (default: "development") |
| `--user-id` | `-u` | User ID for the conversation (optional) |
## Examples
### Replay a recorded conversation
Bash
```
voiceflow dialog replay -f my-conversation.json
```
This will replay all interactions from the recording file against your Voiceflow project.
### Replay with a specific user ID
Bash
```
voiceflow dialog replay -f my-conversation.json --user-id user123
```
This allows you to maintain consistent user state or test with specific user profiles.
### Replay in production environment
Bash
```
voiceflow dialog replay -f my-conversation.json -e production
```
Replays the conversation using your production environment settings.
## How replay works
The `replay` command:
1. Reads the recorded conversation file specified with `-f`
2. Processes each interaction in sequence, automatically sending user inputs to the Voiceflow API
3. Displays the responses from your Voiceflow project for each interaction
4. Adds brief pauses between interactions to simulate natural conversation timing
## Creating recording files
To create a file for replay, use the `dialog start` command with the `--record-file` option:
Bash
```
voiceflow dialog start --record-file my-conversation.json
```
During the conversation, every interaction will be saved to the specified file. When you finish the conversation (by typing `exit` or pressing `Ctrl+C`), the complete recording will be available for replay.
## Troubleshooting
If the replay produces different results than the original conversation:
1. Check if your Voiceflow project has been modified since the recording
2. Verify you're using the same environment that was used during recording
3. Consider using a consistent user ID if your project relies on user-specific state
4. Ensure any external APIs or services your project depends on are available
Updated 5 months ago
---
[Start](/docs/start)[Knowledge base](/docs/knowledge-base-1)
Ask AI
* [Table of Contents](#)
* + [Replay command](#replay-command)
+ [Usage](#usage)
+ [Options](#options)
+ [Examples](#examples)
+ - [Replay a recorded conversation](#replay-a-recorded-conversation)
- [Replay with a specific user ID](#replay-with-a-specific-user-id)
- [Replay in production environment](#replay-in-production-environment)
+ [How replay works](#how-replay-works)
+ [Creating recording files](#creating-recording-files)
+ [Troubleshooting](#troubleshooting)