---
title: "How to edit a scenario in Scenario Builder"
description: "Instructions for editing a scenario in Scenario Builder — the new module that replaces Scenario Dialog."
---

# How to edit an existing scenario in Scenario Builder?

**Scenario Builder** is a new module that replaces Scenario Dialog. This guide helps you make changes to a scenario and save them.

## When you need it

- You need to update message texts.
- You need to add new nodes or sections.
- You need to fix the logic of transitions between nodes.

## What you need to know

- **Concurrent editing** — if another user edits the same scenario, saving may be blocked. If an administrator has enabled co-editing, you can work in parallel in different sections — see [How to edit a scenario together with colleagues](/en/scenariobuilder/how-to/edit-scenario-together.md).
- **Version history** — each save creates a new version that can be restored.
- **Auto layout** — a button in the toolbar aligns nodes by execution flow.

## Before you start

- [x] You are logged in with integrator or administrator rights.
- [x] You have access to the scenario.
- [x] Scenario Builder editor is open.

## Step-by-step instructions

### 1. Open the scenario

1. Go to **Scenario Builder** or **Process Library**.
2. Select the bot and click **«Open constructor»**.
3. Select the section to edit in the left panel.

### 2. Edit a node

1. Click on a node — **Node Inspector** opens on the right.
2. Make changes: message text, buttons, action parameters, etc.
3. Changes are saved when you click «Save» in the toolbar.

### 3. Add a new node

1. Click **«+»** on the canvas.
2. Select the node type from categories (Main, Messaging, Data, etc.).
3. Connect the new node to existing ones via edges.

### 4. Delete a node

1. Click on the node.
2. In Node Inspector, click **«Delete»** or press `Delete` on the keyboard.
3. Confirm deletion.

### 5. Search nodes

1. Click the **magnifying glass** in the top toolbar or press **Ctrl+K** (Mac: **⌘K**) to open canvas node search.
2. Type a query and click a row in the list — the canvas focuses the node; you can keep the panel open.
3. For details (all sections, history, stepping through results): [How to find a node on the canvas](/en/scenariobuilder/how-to/find-nodes-on-canvas.md).

### 6. Save changes

1. Click **«Save»** or press `Ctrl+S` (Mac: `Cmd+S`).
2. Optionally add a comment to the version when saving.

## Related materials

- [Find a node on the canvas](/en/scenariobuilder/how-to/find-nodes-on-canvas.md)
- [Edit a scenario together with colleagues](/en/scenariobuilder/how-to/edit-scenario-together.md)
- [Create scenario](/en/scenariobuilder/how-to/create-scenario.md)
- [Create section](/en/scenariobuilder/how-to/create-section.md)
- [View version history](/en/scenariobuilder/how-to/view-scenario-history.md)
- [Scenario Builder hub](/en/scenariobuilder/integrator-hub.md)