---
title: "How to export and import a scenario in Scenario Builder"
description: "Instructions for exporting and importing scenarios in Scenario Builder — the new module that replaces Scenario Dialog."
---

# How to export or import a scenario in Scenario Builder?

**Scenario Builder** is a new module that replaces Scenario Dialog. Export and import allow you to save a backup or transfer a scenario between projects.

## When you need it

- You need to create a backup before major changes.
- You need to transfer a scenario from one project to another.
- You need to restore a scenario from a file.
- You need to share a scenario with the team.

## What you need to know

- **Export** — saving the scenario structure to a file (JSON).
- **Import** — loading a scenario from a file with support for conversion from Scenario Dialog format.
- **Conversion** — when importing from the old format, the system automatically converts the data.

## Before you start

- [x] You are logged in with integrator or administrator rights.
- [x] You have access to the scenario.
- [x] For import: you have a file with an exported scenario.

## Export scenario

### 1. Open Scenario Builder

1. Go to **Scenario Builder** or **Process Library**.
2. Select the bot and open the editor.

### 2. Open export menu

1. In the top toolbar, find the **«Export»** button.
2. Click — a modal with options opens.

### 3. Configure and export

1. Select what to export: all sections or current only.
2. Optionally include translations.
3. Click **«Export»** — the file downloads to your computer.

## Import scenario

### 1. Open import menu

1. In the toolbar, find the **«Import»** button.
2. Click — a modal opens.

### 2. Upload file

1. Click **«Select file»** or drag the file into the window.
2. Select the file with the exported scenario.
3. The system checks format and data validity.

### 3. Configure import options

1. Choose: **Replace existing** or **Add to existing**.
2. Optionally create a backup before import.
3. Click **«Import»**.

### 4. Save changes

1. After import, check the structure on the canvas.
2. Click **«Save»**.

## Related materials

- [Create scenario](/en/scenariobuilder/how-to/create-scenario.md)
- [Edit scenario](/en/scenariobuilder/how-to/edit-scenario.md)
- [Scenario Builder hub](/en/scenariobuilder/integrator-hub.md)