> ## 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.

# Scripts and script scenes

> Add scripts to a production, then jump to any script scene.

A production can hold several scripts. Every scene heading in a script becomes a script scene, and each script scene holds the 3D scenes you build for it.

![The Rooftop Test script open in Spark. Box 1 is on the script name in the breadcrumb, 2 on script scene 3 with a count of 2, 3 on the View and Edit switch, 4 on the 3D scene list, 5 on Download and 6 on Settings.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/script-page-overview.jpg?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=819b3d95e7361c3e66a7be74f669b56c)

1. Script switcher
2. Script scene, with its number and 3D scene count
3. **View** and **Edit**
4. 3D scenes, with **Create a new 3D scene**
5. **Download**: Fountain or PDF
6. **Settings**: **General** and **Page format**

* Click the switcher's arrow to open another script in this production.
* For **View** and **Edit**, see [Script editor](https://docs.lightcraft.pro/spark/scripts/script-editor.md).
* For scene numbers and **Page format**, see [Scene numbers and page format](https://docs.lightcraft.pro/spark/scripts/page-format.md).

## Scripts, script scenes and 3D scenes

Spark uses four terms that sound alike. Each one names a different thing.

| Term | What it is |
| - | - |
| Script | A screenplay in a production. Spark keeps it in Fountain format. |
| Script scene | One scene heading in the script, such as `INT. STUDIO - DAY`. |
| 3D scene | A set you build for a script scene. A script scene can hold several. |
| Scene editor | The **3D Scene** tab, where you build a 3D scene. |

Scene headings don't make 3D scenes on their own. Each script scene starts with none, and you add each 3D scene with **Create a new 3D scene**. Spark names it after the script scene.

![A 3D scene card named INT. PARK - DAY. Box 1 is on 1 setup, 2 on 1 camera and 3 on 1 take.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/scene-card-counts.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=9debd32637633ddd2582e19e0adc6c8f)

1. **Setups**
2. **Cameras**
3. **Takes**

Setups include the Base Setup, and cameras count across all setups. Takes are one CG Take for each camera, plus any takes you record.

## Add a script

On the production's **Scripts** tab, click **Add a Script**. Pick one of these options.

| Choice | What it does |
| - | - |
| **Upload** | Brings in a `.fountain`, `.txt`, `.fdx` or `.pdf` file. |
| **Use default script** | Adds the Fountain Syntax Guide, a sample script that shows every screenplay element. It opens in Edit, ready to write. |
| **Skip to 3D scene** | Adds an empty script with one 3D scene, and opens that 3D scene in the scene editor. |
| **Start from a library scene** | Copies a scene from the scene library into a new script. See [Start from a library scene](https://docs.lightcraft.pro/spark/scene-editor/3d-scenes.md#start-from-a-library-scene). |

To upload a file:

### 1. Choose the file

Click **Add a Script**, then **Upload**. Drag your file into the window, or click **Choose from browser**.

![The Scripts page with the Add a Script menu open. Box 1 is on Add a Script and 2 on Upload.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/add-script-menu.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=021184e1b0ca286b05e70e88ce4fb067)

1. **Add a Script**
2. **Upload**

![The Upload Script window, with a box on Choose from browser under Drag and drop.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/choose-from-browser.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=9676b285351825b0193d458a2db93fa6)

### 2. Check the preview

Spark shows the script as it will read.

![The Upload Script window showing harbor-test as it will read, with a box on the name field.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/upload-preview.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=04c4f74752ff79447d915128ac35df2a)

### 3. Upload it

Click **Upload**. The script appears in the list.

![The top of the Upload Script window, with a box on Upload.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/upload-button.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=41b9d96e0a843d448959fdd3243586b8)

If the file has a title page, Spark names the script after its `Title:` line. Otherwise the script takes the file's name. Spark turns a PDF into Fountain when you upload it.

## Scripts with no scene headings

3D scenes attach to scene headings, such as `INT. KITCHEN - DAY`. If a file has none, the upload preview warns **No scene headings found**. **Upload** still works.

![The Upload Script window for The Last Ferry - Dock Pickups, with a box on the No scene headings found warning and its kitchen example.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/upload-no-scene-headings.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=106dd7ab7a78324a58d4dcb16d969059)

The script page then lists **Unassociated Scenes**, with a **No scene headings yet** box. You can build 3D scenes there until the script has a heading.

![The script page of a script with no scene headings. Box 1 is on Unassociated Scenes, 2 on the No scene headings yet box and 3 on Edit script.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/no-scene-headings-yet.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=16565bdb9569111bfcf077c7d4f52867)

1. **Unassociated Scenes**
2. **No scene headings yet**
3. **Edit script**

Add a heading and publish the script. The box goes away, and the heading joins **Script scenes**.

## Jump to a script scene

Click a heading under **Script scenes**. Spark highlights that scene in the script, and the 3D scene list shows its 3D scenes. To find a heading in a long script, enter part of it, or its scene number, in **Search**.

To give the 3D scenes more room, click the arrow on the left edge of the 3D scene list. The script collapses, and each 3D scene shows as a row with its setups, cameras and takes.

![The script page with the script collapsed. Box 1 is on the arrow that expands the script again, and 2 on a 3D scene row.](https://mintcdn.com/lightcraft/ZxidYs9zL3IBiWWI/images/spark/scripts/collapsed-scene-rows.png?fit=max\&auto=format\&n=ZxidYs9zL3IBiWWI\&q=85\&s=40592ff23076a9fa39a2befe3ba8cc90)

1. Collapse or expand the script
2. 3D scene row

Point at a row to open its **…** menu.

## Switch between scripts

In the breadcrumb at the top, click the arrow beside the script's name, then pick another script. The **Scripts** tab also lists every script, with how many 3D scenes each holds.

## Rename or delete a script

On the **Scripts** tab, click **⋯** at the end of the script's row.

* To rename, click **Settings**, change **Title**, then click **Save**. On the script page, **Settings** then **General** opens the same window.
* To delete, click **Delete**, then **Delete** again to confirm.

> [!WARNING]
>
> Deleting a script also deletes its 3D scenes, cameras and takes, for good.

## Related

> [card] [Script editor](https://docs.lightcraft.pro/spark/scripts/script-editor.md)
>
> Write and format the script.

> [card] [Drafts and versions](https://docs.lightcraft.pro/spark/scripts/versioning.md)
>
> Publish edits and bring in a newer draft.

> [card] [3D scenes](https://docs.lightcraft.pro/spark/scene-editor/3d-scenes.md)
>
> Open the 3D scenes of a script scene.


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