SceneItAll Docs

Scripts

Manage script revisions

Scripts go through many drafts. SceneItAll tracks each draft as a revision, labeled with an industry-standard revision color. Revisions separate screenplay reading, comparison, comments, continuity, and translation. Production work downstream of the script—Breakdown, Crew, Schedule, and Reports—is shared by the episode and follows its latest production-ready revision automatically.

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.

[SCREENSHOT: The Revision selector dropdown open, showing the revision list with stars and the Revision Settings and Upload Revision actions]

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.

The new revision joins the list and becomes active in the script viewer. SceneItAll automatically maps its scenes onto the episode’s shared production scenes, so existing breakdowns and scheduled placements carry forward. New scenes appear as unscheduled in every scenario. 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.

If a rewritten scene could match more than one existing production scene, the new revision waits for review and production continues using the previous ready revision. An Owner or Admin can select Review scene matches on the Script warning, then match each ambiguous scene to an existing production scene or create it as a new one. The new revision becomes the production source only after every match is resolved.

Rename or recolor a revision

Renaming and recoloring both happen in the Revision Settings dialog.

  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 and removes the revision and all of its scenes.

  1. Select the revision, then open Revision Settings.
  2. Select Delete revision (shown in red).
  3. A confirmation dialog warns that the revision and all its scenes — and any comments on those scenes — 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.