> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exec.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit a Scenario

> Refine a published scenario in Scenario Studio without remixing or rebuilding

You can edit any published scenario you own directly in the Scenario Studio. Open it once and refine the description, character, voice, evaluation criteria, session settings, or anything else — your changes save back to the same scenario, so participants always see the latest version.

<Note>
  You must be the **owner** of a scenario or have been granted **editor access** to make changes. Owners can designate others as editors.
</Note>

***

## Opening a Scenario in the Studio

There are two ways to open a scenario for editing. Both lead to the same place.

<Steps>
  <Step title="From the three-dot menu">
    On any scenario you own, click the **three-dot menu (⋯)** in the top-right corner and select **Edit Scenario**.

    <Frame>
      <img src="https://mintcdn.com/exec-79a6bbdb/SDhPZUTozg3bZBVQ/images/scenario-studio-v2/3-dot-menu.png?fit=max&auto=format&n=SDhPZUTozg3bZBVQ&q=85&s=783a623e6f7c004855a11bd1064e9974" alt="Three-dot menu showing Edit Scenario, Clone Scenario, Remix Scenario, Add to Collection, and Delete Scenario" width="3200" height="2000" data-path="images/scenario-studio-v2/3-dot-menu.png" />
    </Frame>
  </Step>

  <Step title="From a pencil icon">
    Pencil icons appear next to sections of any scenario you can edit — your Objective, Scenario Context, Character details, and so on. Click any pencil to open the Studio directly on that section.

    <Frame>
      <img src="https://mintcdn.com/exec-79a6bbdb/SDhPZUTozg3bZBVQ/images/scenario-studio-v2/pencil-icons.png?fit=max&auto=format&n=SDhPZUTozg3bZBVQ&q=85&s=85baaafe065ab2a4528b589b92a531e1" alt="Scenario detail page with pencil icons indicating sections you can edit" width="3200" height="2000" data-path="images/scenario-studio-v2/pencil-icons.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  The pencil icons only show on scenarios you own. They're a quick visual signal for which scenarios you have permission to edit.
</Tip>

***

## The Scenario Studio

When you open a scenario for editing, the Studio loads with:

* **The AI Agent chat** on the left — describe a change in plain language and the agent applies it across the relevant fields
* **A live preview** on the right — every change you make appears here in real time before you save
* **Five tabs** at the top of the preview — Basic Details, Scenario Details, Character Details, Session Settings, and Advanced
* **Try Now** and **Apply Changes** buttons in the top-right — test before saving, then publish your edits

<Frame>
  <img src="https://mintcdn.com/exec-79a6bbdb/SDhPZUTozg3bZBVQ/images/scenario-studio-v2/scenario-details.png?fit=max&auto=format&n=SDhPZUTozg3bZBVQ&q=85&s=65bcca15f53b4077e5b2ac973d996130" alt="Scenario Studio editing view with agent chat on the left and the live preview with five tabs on the right" width="3200" height="1440" data-path="images/scenario-studio-v2/scenario-details.png" />
</Frame>

You can edit any field either by typing instructions to the agent ("make the character more skeptical about budget") or by clicking the pencil icon on a section and editing it directly. Both approaches save to the same place.

***

## What You Can Edit

<AccordionGroup>
  <Accordion title="Basic Details" icon="file-lines">
    * **Scenario Description** — The summary participants see in the library
    * **Introduction Audio** — The script that gets converted to narrated audio and plays before the session starts. Preview it to check tone before saving.
    * **Difficulty** — The difficulty label (Easy, Medium, Hard, etc.). This sets participant expectations only; changing the label does not change AI behavior.
    * **Tags** — Organize scenarios into themes for easier search and filtering

    <Frame>
      <img src="https://mintcdn.com/exec-79a6bbdb/SDhPZUTozg3bZBVQ/images/scenario-studio-v2/basic-details.png?fit=max&auto=format&n=SDhPZUTozg3bZBVQ&q=85&s=863ea963b73a2a8f4864da66cf000057" alt="Basic Details tab showing description, introduction audio, difficulty, and tags" width="3200" height="1440" data-path="images/scenario-studio-v2/basic-details.png" />
    </Frame>
  </Accordion>

  <Accordion title="Scenario Details" icon="book-open">
    The full body of the scenario — situation dynamics, your objective, outcomes to avoid, evaluation criteria, and any background context the participant should see.

    Edit any section inline or describe the change to the agent ("add a section about Q3 revenue pressure"). Evaluation criteria can be added, removed, reordered, or rewritten directly.
  </Accordion>

  <Accordion title="Character Details" icon="user">
    * **Photo** — Choose from the gallery, upload your own, or search natural language ("Female government worker")
    * **Identity** — Name, job title, and company
    * **Voice** — Region, accent, age, and gender of the AI character's voice
    * **Opening Line** — The first thing the AI says. A pointed opener like "We're already using a competitor — why should we switch?" raises stakes immediately; a casual opener leads to a slower warm-up.
    * **Backstory** — Hidden context only the AI character knows
    * **Situational Understanding** — What the character knows about the current situation (also hidden from participants)
    * **Personality** — Adjust sliders for Assertiveness, Emotional Intelligence, Interaction Style, Stress Response, and Reasoning Style, or switch to a custom description
    * **Conversation Guidelines** — Structured triggers, responses, and free-form character notes that control how the character behaves at specific moments. See [Conversation Guidelines](/roleplays/conversation-guidelines) for the full editor.

    <Frame>
      <img src="https://mintcdn.com/exec-79a6bbdb/SDhPZUTozg3bZBVQ/images/scenario-studio-v2/character-details.png?fit=max&auto=format&n=SDhPZUTozg3bZBVQ&q=85&s=438f185351ba3dae7a1f519bb402488d" alt="Character Details tab showing identity fields, voice settings, opening line, and personality sliders" width="3200" height="1440" data-path="images/scenario-studio-v2/character-details.png" />
    </Frame>
  </Accordion>

  <Accordion title="Session Settings" icon="gear">
    Controls how the session is set up for the learner:

    * **Scenario Language** — Sets the language for the AI Coach, introduction audio, and intro script
    * **Enable Webcam** — Learner appears on video during the session
    * **Enable Screen Share** — Learner can share their screen with the AI character
    * **Enable Cold Call Settings** — Simulates an incoming call with dial tone and end-call phrases
    * **Allow Presentation** — Let learners present uploaded files inside the session

    <Frame>
      <img src="https://mintcdn.com/exec-79a6bbdb/SDhPZUTozg3bZBVQ/images/scenario-studio-v2/session-settings.png?fit=max&auto=format&n=SDhPZUTozg3bZBVQ&q=85&s=026a7c872a4d78c28e1111d2fe147468" alt="Session Settings tab showing language, webcam, screen share, cold call, and presentation toggles" width="3200" height="1440" data-path="images/scenario-studio-v2/session-settings.png" />
    </Frame>
  </Accordion>

  <Accordion title="Advanced" icon="sliders">
    **Conditional Context** — Add extra background the AI character receives based on a participant's profile. See [Conditional Context](/roleplays/conditional-context) for the full setup.
  </Accordion>
</AccordionGroup>

***

## Testing and Saving

* Click **Try Now** to start a quick test session against the version you're editing. Adjust through the agent chat if something feels off.
* Click **Apply Changes** to save back to the published scenario. Anyone who runs it next will get the new version.

<Tip>
  Test before applying any change that affects character behavior — voice, opening line, personality, or backstory updates can shift the conversation in ways that aren't obvious from reading the preview.
</Tip>

***

## Edit vs. Remix vs. Clone

| Action    | When to use it                                                                                                           |
| :-------- | :----------------------------------------------------------------------------------------------------------------------- |
| **Edit**  | You want to update the current scenario. Everyone who runs it next sees the new version.                                 |
| **Remix** | You want a variation (different audience, tone, or stakes) and want to keep the original intact. Creates a new scenario. |
| **Clone** | You want a fresh copy to make a one-off, independent version. Creates a new scenario.                                    |

See [Remix a Scenario](/roleplays/remix-scenario) and [Clone a Scenario](/roleplays/clone-scenario) for the workflows.

***

## Getting Help

**Need help?** Contact us at [hello@exec.com](mailto:hello@exec.com) for guidance on editing scenarios or any questions about Scenario Studio.
