SceneItAllDocs

Scripts

Manage script revisions

Scripts go through many drafts. SceneItAll tracks each draft as a revision with an industry-standard revision color. You can read, compare, comment on, check, and translate each revision separately. Breakdown, Crew, Schedule, and Reports use the latest revision accepted for production while keeping the work already attached to matching scenes.

Before you start

Within one episode, two revisions cannot share the same revision date. The date determines which completed, non-archived revision supplies the current screenplay text and scene details to production workflows.

  • A project and episode are selected in the top bar. The revision control appears only while you are in Scripts.
  • You have the Admin role (or are the project Owner) to upload, rename, archive, delete, or restore revisions. Anyone can switch between revisions.

Find the revision controls

While you are in Scripts, the Revision selector sits in the top bar, just left of the Episode selector (or the Project selector on Feature Film and Short projects). It shows the current revision’s label. Open it to see every revision for the current episode plus the management actions: Revision Settings, Upload Revision, and Show Archived. It is intentionally absent from Breakdown, Crew, Schedule, and Reports because those areas are episode-scoped.

Switch revisions

Open the Revision selector and choose a revision. The script body updates immediately. Each row shows the revision date and its color label, a check on the current one, and a star.

If you select an older completed revision, a red Not latest revision chip appears in the top bar. Hover over it on desktop, or tap it on a touch device, to see which revision you are viewing and which revision is the latest. The chip is informational: use the Revision selector when you are ready to switch. On narrow screens the shorter label Older revision is shown.

SceneItAll refreshes this check while the app is open, so a newer completed revision uploaded by another team member will also trigger the warning. A revision that is still processing, or whose import failed, does not count as the latest workable revision.

Which revision opens automatically

When you choose an episode through ordinary app navigation, SceneItAll opens its newest completed, non-archived revision. Revisions that are processing or failed are skipped. An explicit older-revision link stays on the revision named in that link, and selecting an older revision manually does not get replaced while you work.

Select the star on a revision to mark your personal revision preference and open it immediately. The automatic episode entry rule still favors the newest completed revision so you do not accidentally resume production work on an older draft.

Upload a new revision

  1. Open the Revision selector and choose Upload Revision (the + entry, Admin only).
  2. The upload-revision dialog opens, linked to the current script. Add the file and set its Color and unique revision date.
  3. Select Upload.
  4. Review every row in Adjust scene mappings, then select Accept mappings.

The first dated script in an episode is accepted automatically. Every later revision waits for you to accept its scene matches, even when they all look unchanged.

SceneItAll treats small formatting differences such as 2.a, 2 A, and 2A as the same scene number when suggesting matches, while keeping the label from your uploaded script. It can also suggest numbers such as 27A and 27B for unnumbered scenes inserted between scenes 27 and 28.

Before acceptance, the new revision is readable in Scripts, but Breakdown, Schedule, and Reports continue using the previous ready revision. Choose an existing production scene to carry its breakdown and schedule identity forward, or choose Create new production scene. A duplicate previous identity or an unresolved row blocks acceptance. Cancelling is safe and resumable from Review scene matches on the Script warning.

After acceptance, matching scenes keep their existing schedule placement, including their shoot day, order, and unscheduled production unit. New scenes appear as unscheduled in every scenario under their assigned unit, or the project’s default unit when they do not have one yet. A removed scene stays on any shoot day where it was already scheduled and is marked as absent from the latest revision. For the full upload flow, see Upload a script.

Correct an accepted mapping

An Owner or Admin can open View → Adjust scene mappings on the newest accepted revision. Change the dropdowns and accept the complete table again. This changes which existing production scene each uploaded scene matches; it does not edit the uploaded scene number or slugline.

Each existing scene can be selected only once. For example, swapping scene 12 and 13 still requires two different matches. You cannot adjust an older revision after a newer one has been accepted.

Rename or recolor a revision

Renaming and recoloring both happen in the Revision Settings dialog.

If the selected revision is published, first use Published → Revert to Draft in the script viewer. Published revisions cannot be renamed, recolored, archived, or deleted.

  1. Select the revision you want to change, then open the Revision selector and choose Revision Settings.
  2. Edit the Revision Name field to type a custom label, and pick a standard color from the Revision color dropdown.
  3. Select Save.

Recoloring updates the revision’s color label everywhere it appears. See the revision colors reference for the standard sequence.

Archive a revision

  1. Select the revision, then open Revision Settings.
  2. Select Archive Revision.

Archived revisions leave the active Script list but are not deleted. Breakdown, scenarios, scheduled placements, and reports remain available because they belong to the episode rather than to that revision. Production workflows fall back to the latest completed, non-archived, production-ready revision. Restore the revision with Show Archived at the bottom of the Revision selector.

Delete a revision

Deleting is permanent. It removes the revision, its script scenes, and comments made on that revision. Matching production scenes, breakdowns, and schedule placements remain available through the other revisions.

  1. Select the revision, then open Revision Settings.
  2. If it is published, revert it to a draft first.
  3. Select Delete revision (shown in red).
  4. A confirmation dialog warns that the revision, its source scenes, and script-scoped comments will be removed. Confirm to proceed.

This cannot be undone.

Restore an archived revision

  1. Open the Revision selector and choose Show Archived.
  2. In the Archived Revisions dialog, find the revision and select Restore.

The revision returns to the active Script list. If it is the newest production-ready revision by date, its screenplay data becomes the current production source without replacing shared breakdown or schedule state.