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

# Add Puzzles and Clues

> Build the ordered Puzzle and Clue structure Game Masters use during a Room Session.

Puzzles are the challenges in a Room; each has ordered Clues the Game Master can
send. Edit them in **All Rooms → Edit → Puzzles & clues**, or from the Room
Dashboard during a game.

![Puzzles and clues editor for The Curator's Vault showing ten named Puzzles and the selected Counterfeit Seal Clue ladder](https://mintcdn.com/escape-director/D8kFJ4SKnmjTUX8Y/images/puzzles-and-clues.png?fit=max\&auto=format\&n=D8kFJ4SKnmjTUX8Y\&q=85\&s=f14265a106d331fec5ad846ac41f4a92)

The Puzzle rail stays visible while you edit one Puzzle and its Clue ladder.

## Add a Puzzle

1. Select **Puzzle** at the bottom of the Puzzle list and enter a short name.
   To group Clues without adding a Puzzle to solve, select **Section** instead;
   it doesn't count toward completed Puzzles. To switch later, use **Convert to
   Section** or **Convert to Puzzle** in **Puzzle options**.
2. Add the answer and a short internal description if they help the Game Master.
3. Add Clues in order, from a light nudge to direct help. Use the attachment
   actions beside **Clue** for an image, audio, or video from the Media library.
4. Changes save on their own. A change that can't save yet, such as an empty
   Clue or a Puzzle with no name, shows **Not saved yet** with the reason.

Order Puzzles the way players usually solve them. Write Clues for players;
keep staff notes in the Puzzle description.

## Edit Puzzles and Clues from the Room Dashboard

You can add and edit Puzzles and Clues from the Room Dashboard, even during a game.

* **Puzzle:** select **+** at the top of the Puzzles list, or **Edit Puzzles**
  and then **Edit Puzzle** from a Puzzle's actions. Turn **Can be marked
  complete** off for a Clue Section.
* **Clue:** select the Puzzle, then **+** at the top of the Clues list. Choose
  **Text**, **Image**, **Audio**, or **Video**, type the text or choose the file
  from **Room media**, and select **Create Clue**. To edit or reorder Clues,
  select **Edit Clues**.

How it differs from the editor:

* A change to **Can be marked complete** during a game applies to the next game.
* You can delete a Puzzle only after deleting its Clues. In the editor, deleting
  a Puzzle also deletes its Clues.
* A media Clue can only use a file already in the Media library. Upload new files
  in [Manage Room Media](https://docs.escapedirector.com/build-your-rooms/manage-room-media.md).
* You can't add or edit Puzzles or Clues while the Room Dashboard is offline.

> [!WARNING]
>
> Deleting a Puzzle deletes its Clues; past Room Sessions stay the same. Deleting a
> Media library file also deletes every Clue that uses it. Review the confirmation
> before continuing.

## Next

[Manage Room Media](https://docs.escapedirector.com/build-your-rooms/manage-room-media.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.