Version history

Version history is helpful if you want to save checkpoints while modeling machines or mirror version changes in the rest of your codebase. New versions can be saved from the current machine using the Version history panel in the right tool menu when in Design mode.

All users can view versions of public machines. Users on our Pro plan and team members can view and create versions for machines in team projects and their own machines in My Projects. Read more about team roles and versions.

Version history is a Pro feature of the Stately Studio. Check out the features on our Pro plan or upgrade to try the Pro plan with a 30-day free trial.

Save a version

You can save a new version of your machine when in Design mode.

1. Open the Version history panel from the right tool menu.
2. The Current version of the machine is selected by default. Use the Save button to create a new version from your current machine.

The Save button will be disabled unless you have changed your machine since you created the latest version.

Versions are named with their creation time by default and have the version creator’s avatar.

Initial versions

An initial version is automatically made for new machines created when:

• you fork a machine from an existing machine or project
• you duplicate an existing machine in its project

These machines are labeled “Initial version” and use the Stately bot icon.

Rename a version

You can rename any version to something other than the version’s timestamp.

1. Select the version name to reveal the text input.
2. Enter the version’s new name.
3. The new name will be autosaved when you hit enter or navigate away from the text input.

The version’s timestamp will still be shown under the version name.

View a version

You can view any version by selecting that version in the Version history. The version will be shown in the Editor and read-only unless you restore that version using the Restore button.

You can return to viewing the current version of your machine from Return to current version in the top bar or by selecting Current Version from the Version history in the right tool menu.

Restore a version

You can restore your current machine to any version from the version history.

If you restore a version without creating a new version for your current machine, your current machine will be autosaved in your version history. These autosaved machine names start with “Pre-restore” and have a Stately Bot icon instead of your avatar.

Restore a version from the Version history panel

1. Open the Version history panel from the right tool menu.
2. Hover over the version you want to restore to reveal the restore icon button.
3. Use the restore icon button to restore to your chosen version.

Restore a version when viewing a version

When viewing a version, you can restore to that version using the Restore button in the top bar.

Create a new machine from a version

You can also create a new machine from a version in your version history.

1. Open the Version history panel from the right tool menu.
2. Select the version from which you want to create a new machine. The version will be previewed in the Editor.
3. Use the copy icon button in the top bar to create a new machine from that version.

Your new machine will be created and opened in the same project with the same name appended with “(copy).”

Delete a version

1. Open the Version history panel from the right tool menu.
2. Select the version you want to delete. The version will be previewed in the Editor.
3. Use the delete icon button in the top bar to delete that version.
4. The current version will then be opened in the Editor.

Team roles and versions

All team members can view past versions of machines in their team’s projects. Team owners, Admins, and Editors can also create and restore versions. Only Owners and Admins can delete versions.

Capability	Owner	Admin	Editor	Viewer
View team machine versions	✅ Yes	✅ Yes	✅ Yes	✅ Yes
Create new versions of team machines	✅ Yes	✅ Yes	✅ Yes	✅ Yes
Restore versions of team machines	✅ Yes	✅ Yes	✅ Yes	🚫 No
Delete versions of team machines	✅ Yes	✅ Yes	🚫 No	🚫 No