Two Documents, One Script: A History of Script Revision Colors and Markup

Every time someone marks up a script, production ends up with two documents: the page that was marked, and the page everyone else is holding. From that moment on, the two drift apart.

This is not a digital problem, and it is not new. It is the oldest logistical problem in staged and filmed storytelling, and almost every convention a production professional recognizes on sight was invented to manage it. Revision colors exist because of drift. A-pages exist because of drift. The asterisk in the right margin, the word OMITTED sitting where a scene used to be, the wavy line running down a script supervisor's page, the eight colored pencils in a 1st AD's prep kit — none of these are a language for describing a script. They are a protocol for keeping separate copies of it in sync.

Read that way, four hundred years of markup convention stops looking like tradition and starts looking like engineering. The interesting question is not how the protocol works. It is what it was compensating for, and whether that thing is still true.

The prompter's book was the only copy that agreed with itself

In the Elizabethan theater, no one held a complete play. Actors were issued their own lines and nothing else, each speech preceded by a cue of a few words spoken by an unnamed character. The reason was commercial: a performer who never possessed the full text could not sell it to a rival playhouse. The consequence was structural. A dozen performers each held a partial, non-overlapping document, and not one of them could reconstruct the play.

The complete version lived in one place — the prompter's book, marked up before performance with cuts, entrances, exits, business and cues. The Folger Shakespeare Library defines promptbooks as play texts marked before performance so the prompter can run the show from them. It was the only copy where the text and the production agreed with each other.

The clearest evidence that these copies diverged comes from how libraries handle them now. The Folger holds over 1,800 promptbooks and catalogs each one as its own object rather than as a copy of whatever printed edition it started life as — a decision the library explained in a post about a promptbook in disguise, where an acting edition had been marked so heavily it no longer functioned as that edition at all.

Sometimes the drift is documented on the page. One 1838 Boston promptbook carries an inscription noting it was marked from the Covent Garden prompt book — a working stage manager copying another house's markup by hand into his own volume, because there was no other way to move it. Four hundred years later, that operation still has a name in film production. It is called recopying your notes.

Colored pencils, and the moment the drift starts

Script breakdown is where a modern production manufactures its own divergence, and it does so deliberately.

The convention is familiar: red for cast, yellow for silent extras, green for atmosphere, blue for practical effects, purple for props, pink for vehicles and animals, brown for sound and music, orange for stunts. What working professionals also know is that the color system ran out before the elements did. Wardrobe has no color — it gets circled, makeup and hair get an asterisk, special equipment gets a box. A system that started with eight colors ended up annexing shapes, which is what a protocol looks like when it grows by patching rather than by design.

Then comes the part that matters. Every marked element is transferred by hand onto a breakdown sheet, one per scene. Those sheets become strips. Those strips become the schedule, on a board whose colors encode the world of the story rather than the shooting day. The same fact about the same scene now exists in four places, and three of them were produced by a person retyping the fourth.

And that is only the master breakdown. A producer builds an early version for budgeting. The 1st AD builds the comprehensive one that drives the schedule. Department heads then build their own on top of it — the DP marking lenses and lighting, the costume designer marking rentals and fittings. One script, one shooting day, and a fan of parallel documents that were each accurate at the moment they were made.

There is an honest description of what a marked-up script is, and it comes from a payroll company's breakdown guide rather than from a philosopher: the marks are an organizational tool for you, personally. Personal is the operative word. A personal copy is, by definition, a copy that diverges.

The lined script: a map editorial has to trust

The script supervisor's lined script is the most literal artifact of drift in the entire process. It is a record of the difference between what the script says and what the camera actually got.

The technique is elegant. A vertical line down the page marks a camera setup. Straight means the dialogue or action was covered on camera; a wavy line means it happened off screen. Setups are labeled by scene number plus letter, skipping I and O so they cannot be misread as 1 and 0. Selected takes are circled. Facing pages carry the setup list, take counts, timings and the director's preferences.

The stakes are asymmetrical in a way outsiders underestimate. This document is the editorial team's route into the footage, delivered daily so assembly can start immediately. If coverage is missing and the lined script does not surface it, the discovery happens in the cutting room — which is to say after the location is gone, the set is struck and the cast is on another job.

The profession itself was invented in response to drift. Shooting out of sequence broke the correspondence between script and material, and someone had to own tracking it. IATSE Local 871, which now covers the craft, was chartered in 1958 with 131 members; the job itself dates to 1918, when the first credited continuity specialist proposed it herself on a Douglas Fairbanks picture. There is a fitting detail. That production changed directors mid-shoot, and the historical record of who directed it has itself split into two defensible versions. The film where continuity was invented could not maintain its own.

The most telling modern detail is smaller. When colored revision pages go out, script supervisors routinely ask for theirs in white, because their marked copy gets photocopied and scanned daily and colored stock reproduces badly. The industry's system for keeping copies in sync had to carve out an exception for the one person whose entire job is tracking divergence.

Revision colors are a notification system, not a style guide

Ask why revision pages are colored and the usual answer is tradition. The actual answer is that it is a broadcast protocol for telling a hundred people which pages in their binder are dead.

Once a script is locked, page and scene numbers freeze permanently. New material cannot be allowed to reflow the document, because that would invalidate every marked-up copy on the production simultaneously. So the system absorbs change without moving anything: inserted pages become 12A and 12B, an added scene between 10A and 10B becomes 10AA, changed lines get an asterisk in the right margin, and a cut scene keeps its number and gets the word OMITTED — partly so a missing page never reads as a printing error.

The sequence runs white, blue, pink, yellow, green, goldenrod, buff, salmon, cherry, tan, then cycles as double white and double blue. Past goldenrod, practice gets inconsistent and most productions never find out, because they wrap first.

The reason all of this exists is worth stating plainly, because it is this entire history compressed into one sentence: issuing only the changed pages spares the crew from transcribing every handwritten note onto a fresh script. The colors are not decoration. They are the cheapest available answer to the question of what happens to everyone's markup when the text underneath it changes.

Digital markup inherited the paper model

Paper is mostly gone. The model it imposed is not.

The pattern of the last fifteen years has been to digitize the pen. Marking moved onto tablets, distribution moved to PDF, and the transfer of annotations from an old revision to a new one got automated well enough to earn an Engineering Emmy in 2021, awarded for automating the transfer of handwritten notes and annotations onto new versions of a script and redistributing them to all departments. That is a real improvement, and pretending otherwise would be dishonest.

But notice what was optimized. The award-winning capability is moving marks between copies faster. The existence of a separate copy was never in question. It was treated as the ground condition of the problem.

The receipts go back further than most people assume. In 2010, Filmmaker Magazine profiled the first serious script supervision software and described its selling point as removing the need to copy slate numbers, camera rolls and preferred takes from the facing page onto the editor's log by hand. One person, two of their own documents, the same data typed twice. That was published eleven years before the annotation-transfer problem got its Emmy, and it describes drift happening inside a single professional's workflow rather than between departments.

The same piece records the compromise practitioners actually made. Its subject advised experienced colleagues to do their breakdowns in the software, then work on paper, then clean up notes at the end of the night — a workflow that runs two copies simultaneously by design. Hybrid lining is still standard practice on fast shoots for the same reason.

Meanwhile the fan of parallel documents from the breakdown stage never went anywhere. Marks live in the annotation app. The breakdown lives in the scheduling software. The schedule lives somewhere else again. Each is a faithful digital reproduction of a paper artifact, including the part where they disagree by Thursday.

What changes when the mark and the script are the same object

A dedicated annotation app gives you a better pen. What it cannot give you is a page already connected to the breakdown, because there is no breakdown inside a PDF reader.

That is the actual difference, and it is worth being precise about what it does and does not mean. Marking up a script in Filmustage does not rewrite your tags or regenerate your breakdown — highlighting a prop is not the same action as tagging one. What changes is location. The markup sits on the same script the breakdown was generated from, not on a copy emailed out afterward. The schedule, the tagged elements and the department notes are looking at one document instead of four.

The toolset is the familiar one, plus a few things paper never offered. Highlight, underline and strikethrough on the text itself. Text boxes placed anywhere on the page. Freehand pen and marker, rectangles and ellipses. Reference images dropped directly onto the script, so a costume reference sits beside the scene it belongs to instead of in a separate folder. And stamps — OMIT, ADDED, REVISED, OK, DATE, or a custom label — which exist because the revision protocol described above is still how productions communicate. All of it works on every plan including Free, with no coins consumed.

Layers are where the departmental logic comes back. Each set of marks lives on its own named, color-coded layer, and any layer can be switched off entirely or expanded to show and hide annotations by type. A layer marked Private stays visible only to you; anything else is shared with collaborators who have annotation access. Personal layers work on every plan, while shared team layers require Team Access. This is the thing paper could never do: several departmental passes on one page, instead of one page per department.

Two details matter more than the tool list. Annotations carry forward when a new version of the script arrives, including handling for marks anchored to text that no longer exists in the revision — the A-pages problem solved at the level of the document rather than the binder.

And the export is selective in a way a binder never was. Annotations and comments are separate checkboxes, and hidden layers are excluded from the PDF entirely. The copy that goes to editorial can carry the script supervisor's pass and nothing else; the copy that goes to the art department can carry theirs. One source document, as many views as the production needs — which is the opposite of how every system in this article worked.

None of this retires the protocol. Revision colors are not going away, and neither is the lined script. But four centuries of convention were built to compensate for a physical constraint: markup and text could not occupy the same object, so the industry engineered an elaborate system for keeping them approximately aligned. When that constraint stops being true, the system stops being load-bearing and becomes what it should have been all along — a shared language rather than a workaround.