---
title: "Writing a script"
description: "How the script editor works, how drafts and versions differ, and what the story bible, statistics and table read show."
url: https://www.filmsquare.ai/docs/departments/writing-a-script/
lang: en
section: departments
updated: 2026-11-13
---

# Writing a script

The editor opens from **Script → Script** with **Write** (a director or higher, or a maker on Writing). It is the
same text as the script you [import](https://www.filmsquare.ai/docs/departments/writing/#bringing-in-the-script): Fountain, kept as a new
version when you save.

## The page

From 900 px wide, you type on a formatted screenplay page: each element in its column, page breaks as you type.
Below 900 px, for instance on a phone, the editor is plain text.

- **Tab** and **Return** move through the elements: **Scene heading**, **Action**, **Character**, **Parenthetical**,
  **Dialogue**, **Transition** and **Centered**.
- **Ctrl 1** to **Ctrl 7** (Cmd on a Mac) or **Alt 1** to **Alt 7** make the line one of those seven, in that order.
- Names on a **Character** line and scene headings complete themselves from the script. **Return** or **Tab** takes the
  suggestion.
- **Ctrl F** finds, with **Replace** and **Replace all**.
- The element menu in the header ends with **Replace character…**: pick a character and a new name, and every cue and
  mention changes in your draft, as one undo step.

## Drafts and versions

A draft is yours and changes; a version never does.

| You do | What happens |
| --- | --- |
| Pause, or **Ctrl S** | The draft is kept. The header says **Draft kept**. |
| **Close** | The draft is kept. **Write** now reads **Continue draft**, with **Draft from v3**. |
| **Discard draft** | The draft is dropped, after you confirm. |
| **Save as v4** (**Ctrl Shift S**) | A new version, with your note. The draft is dropped. |

> [!NOTE]
> The draft is kept in this browser and with your account, so it is there when you open the script in another
> browser or on another device. If it changed in both places since, **This draft changed elsewhere** asks which text to
> keep.

If a newer version came in while you wrote, the header says so, and saving asks first: **Keep writing**, or save on
top of it as the next version. While you type, others on the production see **{name} is writing** next to the
script.

## Writing help from your own Claude

Your own Claude can rewrite or continue a scene, brainstorm, or read the script and report. The prompts
(`rewrite_scene`, `continue_scene`, `brainstorm_script`, `read_report`) are on
[Prompts and working method](https://www.filmsquare.ai/docs/claude/prompts/). A rewrite arrives as a note with a suggestion, in the notes next
to the script.

Select words on the script and choose **Ask Claude**: you get a prompt to paste into your own Claude, ready for that
passage.

## Accepting a suggestion

Whoever may write the script sees **Accept** on a note with a suggestion.

- On the script, **Accept** puts the suggestion in your draft: the draft that waits behind **Continue draft**, or a
  new one from the version on screen. The editor stays closed, so the next suggestion is one click too.
- In the editor, **Notes · 3** in the header opens the same notes beside the page. **Accept** there puts the
  suggestion on the page, with the cursor after it, as one undo step. Choosing a note's quoted words shows them on the
  page. **Esc** closes the notes.
- The card then reads **In your draft**, and **Undo** takes the suggestion out again. Once you change those words
  yourself, **Undo** is gone and the suggestion stays in your draft.
- **Text changed** means the words in your draft are no longer the ones the suggestion was made for.

Accepting changes only your draft. The note resolves when you save the draft as a version (**Save as v4**) with the
suggestion in it. Discard the draft and the note stays open.

## The story bible

Under **Script → Docs**, after the script, the **Story bible** group has six kinds of sheet: **Logline**,
**Synopsis**, **Characters**, **World**, **Outline** and **Style**. A kind with no sheet yet is one row; choosing
it makes the sheet from a template. **Characters** and **World** have a row for each character and each place of the
production's cast and locations. **Outline** first asks for a structure: **Three acts**, **Hero's journey**,
**Story circle**, **Eight sequences** or **Hook and cliffhanger**. Every sheet can be edited with **Edit**.

## Statistics

**Statistics** in the script's header shows the pages, the scenes, the estimated runtime (one page is about one
minute) and the share of dialogue. Two tables below break it down per character (speeches, lines, scenes, share) and
per location (scenes, length).

## Table read

Next to a scene, **Table read** plays the lines that are already spoken, in the voices of the cast. A scene with lines
not spoken yet shows **Speak scene** with the draft price in credits and euros; it links to the shot where it is made
and spends nothing until you do.

## Starting a microdrama

On an empty script in a microdrama production, **Script → Docs** offers **Blank page** and **Microdrama episode**
where other productions show **Write it here**. The second opens the editor on a starter, as a draft: a title page and
the beats **Hook**, **Turn** and **Cliffhanger**, with the cursor on the first scene heading.

## Reading the script as a guest

**Share…** in the version menu (reviewer and up) makes a link to the script alone. It always shows the newest
version, also after you save a new one. **Share** on the board, with the Writing step in view, makes a link to the
whole step: the script and its scenes. Guests sign in with their own account, select a passage and choose **Note this**. Share links
come with a paid plan. Their notes show on the script like your crew's.
See [Notes, pins and review](https://www.filmsquare.ai/docs/working-together/notes-and-review/).
