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

# Script editor

> Read a script in View mode, then write or format it in Edit mode.

The script page has two modes. View shows the published script as a formatted screenplay. Edit opens its text, so you can write and format it. Both lay the script out as pages. See [Scene numbers and page format](https://docs.lightcraft.pro/spark/scripts/page-format.md).

![The Rooftop Test script in Edit mode. Box 1 is on the View and Edit switch, 2 on Add elements, 3 on Save pattern, 4 on the script text and 5 on the Versioning column.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/script-editor-overview.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=669db5850edfd0f5b46706686308f1a4)

1. **View** and **Edit**
2. **Add elements**
3. **Save pattern**
4. Script
5. **Versioning** column

For the **Versioning** column, see [Drafts and versions](https://docs.lightcraft.pro/spark/scripts/versioning.md).

## View and Edit

Click the switch, or press **Ctrl+E** (**Cmd+E** on a Mac). In Edit mode, the **Versioning** column takes the place of the 3D scene list.

Spark saves your typing about 1.5 seconds after you stop, as a draft that only you see. Others see it once you publish it. See [Publish your edits](https://docs.lightcraft.pro/spark/scripts/versioning.md#publish-your-edits).

The status beside **Versioning** shows how saving is going.

| Status | What it means |
| - | - |
| **Saving…** | An edit is being saved. Click **Save now** to save at once. |
| **Saved** | Every edit is saved. |
| **Couldn't save — retrying** | A save failed, and Spark is trying again. Click **Retry now** to try at once. |
| **Saving stopped** | Spark can't save your latest edits. Copy anything you need, then click **Reload**. |

> [!TIP]
>
> The **Light** and **Dark** switch changes only the script page, from a dark page to white paper.

## Write scene headings

Start a line with `INT.`, `EXT.`, `EST.`, `INT./EXT.` or `I/E.`, then the place and the time of day.

```text Scene headings theme={null}
INT. STUDIO - DAY

EXT. ROOFTOP - NIGHT

.FLASHBACK
```

A line that starts with a period counts as a heading too, as `.FLASHBACK` does here. A new heading joins **Script scenes** once you publish.

## Format screenplay elements

Spark uses [Fountain](https://fountain.io) syntax for screenplay formatting. Click **Add elements** to insert an element without typing its syntax.

### 1. Place the cursor

Click in the script where the element should go.

### 2. Insert the element

Click **Add elements**, then click an element. Spark inserts sample text at the cursor.

![The script in Edit mode with the elements panel open. Box 1 is on Add elements, 2 on Scene Heading and 3 on the sample heading it inserted.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/insert-element.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=a7e3693b245fa36735cee05f267e2629)

1. **Add elements**
2. Element
3. Sample text

### 3. Replace the sample

Type over the sample text with your own.

![The script in Edit mode, with a box on the new lines INT. ELEVATOR - NIGHT and Maya rides down alone.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/replace-sample.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=d268828384f4fd9c062812fe6531f3d3)

| Element | What it is | Sample Spark inserts |
| - | - | - |
| Title Block | Title page details | `Title: My Script` |
| Scene Heading | Place and time | `INT. LOCATION - DAY` |
| Action | What happens on screen | `Action description.` |
| Dialogue | A character's name, then their line | `CHARACTER NAME` |
| Parenthetical | How a line is said, between name and line | `(quietly)` |
| Transition | A cut to the next scene, set to the right | `CUT TO:` |
| Centered | Text set in the middle, such as an act break | `>THE END<` |
| Section | An act or section marker that doesn't print | `# ACT ONE` |
| Note | A comment that doesn't print | `[[Director note]]` |

To save your own pattern, select the text, click **Save pattern**, name it, then click **Save**. It appears under **Custom** in **Add elements**.

> [accordion] See every Fountain element in one script
>
> Add a script with **Use default script**. The Fountain Syntax Guide shows each element, including dual dialogue, lyrics, page breaks and emphasis, with the syntax beside it.

## Related

> [card] [Scripts and script scenes](https://docs.lightcraft.pro/spark/scripts/scripts-and-script-scenes.md)
>
> Add, switch and rename scripts.

> [card] [Drafts and versions](https://docs.lightcraft.pro/spark/scripts/versioning.md)
>
> Publish your edits for everyone.

> [card] [3D scenes](https://docs.lightcraft.pro/spark/scene-editor/3d-scenes.md)
>
> Build 3D scenes for each script scene.


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