Version History

Version history gives you a timeline of saved snapshots of your script. You can save versions at key milestones, compare how the script has changed, and restore any previous state if you need to go back.

Saving a version

  1. Open the Versions tab in the right panel.
  2. Click Save Version.
  3. Give it a descriptive name, like "First Draft", "After Notes Session", or "Network Draft", and click Save. (If you leave the name blank, it's named "Version" plus today's date. Names can be up to 200 characters.)

That's it. The current state of the script is saved as a named snapshot.

Anyone who can edit the script can save a version. If you can only comment on it or view it, you can still browse, compare and read its versions, but Save Version isn't shown. Right after a script opens, Save Version can be greyed out while Premiere.Studio checks your access.

A version keeps the script's text and formatting, and the outline. It doesn't keep revision colors and marks, scene colors or breakdown tags, the same things a Fountain file leaves out.

Tip
Save a version before and after every major event: table reads, notes sessions, rewrites, polishes. When you need to look back, you'll be glad you did.

Working with a version

Click any saved version in the list to select it. Each version shows when it was saved and, where available, its scene and word counts. Selecting it reveals its actions: Restore, Compare and, if you're allowed to delete it, Delete.

The list opens on your 100 most recent versions. If the script has more, Show Older Versions at the bottom of the list loads the next 100, as many times as you need, and the count at the top of the panel shows a + while there are more to load. Once the oldest version is in, the button gives way to Start of version history. Nothing is ever dropped from history to make room: older versions work exactly like recent ones, and you can restore, compare or delete them the same way.

Restoring a version

If you want to go back to an earlier state of the script, select that version, click Restore, and confirm.

Before anything changes, Premiere.Studio saves your current draft to version history, named after the version you're restoring (for example, "Before restoring 'Network Draft'"). If that copy can't be saved, nothing is replaced and you'll see why. Then the script is replaced with the saved version for everyone working on it, and the outline saved with that version comes back too, if it has one. The title page stays as it is.

Because versions don't keep revision colors and marks, scene colors or breakdown tags, restoring removes any of those from the current draft, and the copy saved first can't bring them back. The confirmation says so, and turns red when your draft has any.

If someone else edits the script while that copy is being saved, nothing is replaced: their changes stay, and you can restore again so the copy includes them.

Restore isn't offered if you can only comment on or view the script, or while a generation you started in this tab is running. A generation can also be running without this tab knowing, started by a collaborator or in another tab, so Premiere checks for one when you confirm, and stops if it finds one: wait for it to finish, then restore. Restore also won't run in a tab that has stopped saving because the script changed somewhere else: reopen the script first.

Versions saved for you

Premiere.Studio also saves a version automatically before some big changes. Importing a script over the open one, restoring a version, or generating a full script over an existing draft always saves your current draft first, and won't go ahead if it can't. You'll see these in the version list alongside your named versions. They take a place in the list like any other version, so on a script with a long history your older named versions may be further down: use Show Older Versions to reach them.

Deleting a version

Select a version, click Delete, and confirm. A deleted version is gone for good, but your current script isn't touched.

Who can delete which version:

Delete only appears on versions you can delete. A version is the way back if something goes wrong, so one collaborator can't wipe out the history everyone else relies on. If someone else deleted that version first, you'll see a message saying it's already deleted, and it leaves the list. If the delete is refused because your access to the script changed since you opened the list, the message says so and the version stays.

Comparing versions

Select a version and click Compare to see how the current script differs from it, with additions in green and removals in red. This is useful for understanding what was added, removed, or rewritten during a particular stage of development.

Practical advice