Versions and History
This functionality is available on Onshape's browser, iOS, and Android platforms.
You can create versions (which are View only) and branch a version to create a new workspace. You can also compare history entries in workspaces and versions, and any combination of the two. For more information, see Comparing.


You can create a version from the
Document panel;
click
to create a new version without leaving the workspace.
You can also create a version through Versions and history, also located on the Document panel:
-
With a document open, click
to open Versions and history.
- Click the workspace from which to create a version; this makes that workspace active.
-
Click the Create version icon
.
- In the dialog that appears, enter a name and description for the new version.
- If any drawings in the document have updates pending, as indicated by a bright yellow Update icon
, a message is included in the dialog:
Click the icon in the message
to update all drawings that are listed so the version will contain the most recent version of the drawings. Note that if you click the Update icon and then cancel the dialog, the drawings are still updated.
- Click either:
- Create - Creates the new version and remain in the currently active workspace
- Create version and edit properties - Creates the new version and also open the Properties dialog for the new version. This Properties dialog includes names and descriptions for each tab and part of the new version.
The new version is shown in the Versions and history graph:
Onshape may also create a version automatically, when updating document references. In that case, you will see an automatic version icon in the graph, as shown below:
For more information about automatic versioning, see Updating References.

To create a branch of a document:
-
With a document open, click
to open Versions and history.
- Right-click on the version entry from which to create a branch to access the context menu.
- Select Branch to create workspace:
- In the Properties dialog that appears, enter the name and description for the branch:
- Click either:
- Create - Creates the branch and optionally open the new workspace (check box)
- Create version and edit properties - Creates the branch (optionally open it) and also open the Properties dialog for the new workspace. This Properties dialog includes names and descriptions for each tab and part of the new document workspace.
You can compare two workspaces, two versions, or a version and a workspace. You are also able to merge one or more branches.

A team is working on a bicycle and has reached a stable design base for the frame. Now it's time for the team to experiment with various component designs. Begin by marking the basic frame design document as a version.
- Click the Versions and history icon
to open Versions and history in the Document panel:
-
Click the Create Version icon
.
- Name the first version Base Frame; click
Create:
Each designer is then able to create their own workspace from the Base Frame version, perhaps labeled Seat, Brakes, Shocks.
- On the Base Frame version, select Branch to create workspace.... from the context menu:
- Name the new workspace, Seat; click
Create:
The Base Frame version still exists as well as the original workspace (Main). In addition, there is a second workspace, Seat, so the designer making changes for the seat won't affect the Base Frame workspace.
- The Shocks and Brakes designers each create their own workspaces, from the same Base Frame version:
The workspace of each designer is, at this point, identical to the Base Frame version. As they continue to design in their own branches, their designs evolve, independently of the Base Frame version and independently of each other.
As they work, they are free to create versions of the workspaces.

A typical Version and history graph contains icons that indicate the type of workspace, branch, version, or revision each node is. To more fully understand how to read the graph, consider this table:
Icon | Indication |
![]() |
version |
![]() |
change node |
![]() |
A version containing a release that has been approved. |
![]() |
A version containing a release containing an obsoleted item. |
![]() |
A workspace. |
![]() |
A version with a revision pending. |
![]() |
A version in the Version and history that was created automatically by Onshape; for example, when using the Update to latest option as explained later in this topic |

Search history allows you to search history entries across all versions and branches. The result is a filtered list of entries based on your search term. Version names and version descriptions are not included in the search.
To search history:
-
Enter a search term in the Search history field. All history entries including the search term are displayed in the Versions and history list:
-
Optionally, to further narrow your search, click the dropdown arrow in the search history field. This allows you to filter the search using the following criteria:
-
Tab - Narrow the search by selecting a specific document tab. Default is Any tab.
-
Tab types - Narrow the search by selecting either Part Studio, Assembly, or Drawing. Default search uses all tab types. Click the Clear button to reset the tab type filter. Both tab types are included in the search.
-
Modified by - Narrow the search by selecting the person who made the history change. Options are Only me, Not me, or Any (default).
-
Date modified - Narrow the search by selecting the Start and End dates. Default searches all dates.
-
Once the criteria are selected, click the Search button. The search term is filtered according to the new criteria. At any point, you can click the Reset button to set all filter criteria to their default values.
When searching, results are presented from all branches, even if you have selected Active branch above the search field.

With the Version manager, you can create versions (which are read-only) and branch a version to create a new workspace.

You can open the Version manager from the Documents page or from within the document:
- From the Documents page:
Select the Information panel icon that corresponds with the document for which you want to open the Version manager. From here tap Versions.
- From within the document:
Tap the Versions icon in the upper left:

- The Version manager displays the default version graph for a document, notice there is a Main workspace, and a "Start" version by default.
- There are two icons in the upper right of the Version manager:
- Create a version
- Close Version manager
- Tap to switch between viewing All branches and the Active branch (workspace that is active, or open, in the graphics area):
The graph displays all versions and workspaces of a document, in tree form. The graph is color-coded by branch. Each branch is one color, and every branch ends with a workspace, which are depicted as open dots. Branch names are shown with bold and italic text. Versions are depicted as solid dots, and normal text, and are View only.
The active branch, which is the currently open workspace, is indicated by a blue box to the left of the title. In the image above, the branch titled branch sketch is the active branch as is indicated by the blue box to its left.

- Version
- A named and saved state of the document. Versions are immutable and separate from workspaces. Create a version to capture a workspace at a particular point in time. You can open and branch a version.
Indicated by normal text and a solid dot on the version graph.
- Workspace
- A modeling/design space.
The active workspace is indicated by a blue box to the left of it in the version graph list.
- Branch
- Where the document is split and a new workspace is created. A branch can have many versions, but always has a workspace. You can open and delete a branch.
Indicated by bold and italic text and an open dot on the version graph.

To create a version of a document:
- Access the Version manager.
- Open the workspace (or branch) from which to create a version.
-
Tap
.
A workspace (branch) is indicated by an open dot.
To do this, tap to select desired workspace, then tap the Open icon.
- Add a name and description for the version, then select Create.
- The newly created version appears in the Version manager:
Tap on a version to see details and options such as Open, Branch, and Restore.

To create a branch of a document:
- Access the Version manager.
- Tap to select the version from which to create a branch:
- Tap the Branch icon:
- Add a name and description for the branch, and then select Create.
- The newly created branch appears in the Version manager.
Note that both b1 and Main are branches and are indicated as such by the bold and italic text as well as the open dots in the version graph.
Also note that "v1" and "Start" are saved versions and are indicated by the normal text and the solid dots in the version graph.
The branch titled Main has two versions, "v1" and "Start", as is indicated by the blue color of the line. Branch titled b1 does not yet have any saved versions, it is the only item on the yellow line.

Onshape keeps a history of all the changes made to every document by every user. This enables you to view those changes in one list in the document history, and also to restore a document to a specific point in history at any time.
When restoring, the workspace you are in is the one being restored. If you wish to restore to another workspace, open that workspace first.
To restore a version to the currently active workspace:
- Open the Versions flyout.
- Tap the version you wish to restore.
- Tap the restore icon at the top of the flyout.
For more information about restoring versions, see Document Management.

With the Version manager, you can create versions (which are read-only) and branch a version to create a new workspace.

You can open the Version manager from the Documents page or from within the document:
- From the Documents page:
Select the Information panel icon that corresponds with the document for which you want to open the Version manager. From here tap Versions.
- From within the document:
Tap the Versions icon in the upper left:

- The Version manager displays the default version graph for a document, notice there is a Main workspace, and a "Start" version by default.
- There are two icons in the upper right of the Version manager:
- Create a version
- Close Version manager
- Tap to switch between viewing All branches and the Active branch (workspace that is active, or open, in the graphics area):
The graph displays all versions and workspaces of a document, in tree form. The graph is color-coded by branch. Each branch is one color, and every branch ends with a workspace, which are depicted as open dots. Branch names are shown with bold and italic text. Versions are depicted as solid dots, and normal text, and are View only.
The active branch, which is the currently open workspace, is indicated by a blue box around the title. In the image above, the branch titled b2 is the active branch as is indicated by the blue box around it and to its left.

- Version
- A named and saved state of the document. Versions are immutable and separate from workspaces. Create a version to capture a workspace at a particular point in time. You can open and branch a version.
Indicated by normal text and a solid dot on the version graph.
- Workspace
- A modeling/design space.
The active workspace is indicated by a blue box to the left of it in the version graph list.
- Branch
- Where the document is split and a new workspace is created. A branch can have many versions, but always has a workspace. You can open and delete a branch.
Indicated by bold and italic text and an open dot on the version graph.

To create a version of a document:
- Access the Version manager.
- Open the workspace (or branch) from which to create a version.
-
Tap
.
A workspace (branch) is indicated by an open dot.
To do this, tap to select desired workspace, then tap the Open icon.
- Add a name and description for the version, then select Create.
- The newly created version appears in the Version manager:
Tap on a version to see details and options such as Open and Branch.

To create a branch of a document:
- Access the Version manager.
- Tap to select the version from which to create a branch:
- Tap the Branch icon:
- Add a name and description for the branch, and then select Create.
- The newly created branch appears in the Version manager.
Note that both b2 and Main are branches and are indicated as such by the bold and italic text as well as the open dots in the version graph.
Also note that "v1" and "Start" are saved versions and are indicated by the normal text and the solid dots in the version graph.
The branch titled Main has two versions, "v1" and "Start", as is indicated by the blue color of the line. Branch titled b2 does not yet have any saved versions, it is the only item on the yellow line.

Onshape keeps a history of all the changes made to every document by every user. This enables you to view those changes in one list in the document history, and also to restore a document to a specific point in history at any time.
When restoring, the workspace you are in is the one being restored. If you wish to restore to another workspace, open that workspace first.
To restore a version to the currently active workspace:
- Open the Versions flyout.
- Tap the version you wish to restore.
- Tap the restore icon at the top of the flyout.
For more information about restoring versions, see Document Management.
For additional Learning center resources, follow the self-paced courses here: Branching and Merging (Onshape account required) and Document History and Versions (Onshape account required). You can also follow the learning pathway course here: Onshape Fundamentals: Data Management (Onshape account required) and the technical briefing articles here: Understanding and Working with a Document’s Historical Data (Onshape account required) and Gitflow Version Management (Onshape account required).