Onshape has built-in version control that most VRC teams never use. Every version is a timestamped snapshot. A chain of named versions is the most powerful notebook evidence you can produce โ judges can see your design evolving with dates they can verify.
The notebook connection: The EDP rubric asks for evidence of iteration. A screenshot of the Onshape version history panel โ showing v1, v2, v3 with dates and descriptions โ proves your design changed over time without any extra work. You already made the versions. Screenshot them.
๐ How Versions Work in Onshape
Onshape has three states for a document:
Workspace โ the editable, live state. You always work here.
Version โ a named, locked snapshot of the workspace at a point in time. Immutable once created. This is what you use for notebook evidence.
Branch โ a copy of a version that you can edit independently of the main workspace. Use this for experiments.
To create a version: click the clock icon at the bottom of the Onshape screen, or Document menu โ Versions and History โ Create version.
๐ท Season Version Timeline โ Example
๐ Example Season Version History
๐ฟ Branching for Experiments
๐ฟ Branch Workflow
Create a branch: in Version History panel, right-click any version โ Create branch. Name it experiment โ pneumatic-intake. Work freely. If it succeeds, your mentor or lead engineer merges it back into the main workspace. If not, abandon it โ the main design is never touched.
โ Version Naming That Satisfies Judges
Version names are your design story. Bad naming loses the value. Good naming makes the rubric argument for you:
Bad:version 3, save before changes, final
Good:v3 โ replaced 4-bar with 6-bar after load test failure
Good:v5 โ post-Event-1 rebuild โ lowered CG after tipping incident
Good:v7 โ added second intake roller per driver feedback week 3
Each good name is a notebook entry headline. When you screenshot the version history for the notebook, judges read each line as evidence of your design process.
Collaboration: Every team member who makes a version has their name attached to it automatically in Onshape. The version history shows who made each decision and when. For teams with multiple CAD contributors, this is built-in attribution โ no one needs to remember who made which change.
๐
OFFICIAL ONSHAPE โ VERSION HISTORY
Version creation, branching, comparing versions, and restoring previous designs
⚙ STEM HighlightComputer Science: Version Control & Design History
Onshape's built-in version control applies the same concepts as Git: named versions (commits), branches (parallel design explorations), and history (complete audit trail). In professional engineering, design history is not just documentation — it is liability and knowledge management. A version labeled "Competition 1 — frozen" ensures the team can always return to a known working state after experimental changes. This practice is standard in aerospace, automotive, and medical device engineering for exactly this reason.
🎤 Interview line: “We create a named Onshape version before every competition and before any experimental change. Our version history shows the evolution from our first drivetrain concept to our competition robot — each version linked to a specific design decision. This practice saved us twice: once when an experimental branch introduced a clearance issue, and once when a competition version was needed for reference after V2 development had already begun.”
You want to test a new intake concept without risking your competition CAD. What is the correct Onshape workflow?
⬛ Edit the main workspace directly — you can always undo with Ctrl-Z
⬛ Create a named version of your current design, then create a branch from it for the new concept — your main workspace stays untouched
⬛ Create a second Onshape document and copy all parts into it
📝
Notebook entry tip:Build & Program — Orange slide — Include an Onshape version history screenshot in your CAD documentation. Annotate each major version with the design decision that triggered it and what changed. A version timeline — "V1: initial drivetrain → V2: four-bar added → Competition 1 freeze" — is compelling evidence that your CAD was managed as a living engineering document, not a one-time deliverable.
Vocabulary, discussion questions, and the official PTC/Onshape Collaboration unit guide.
Key Vocabulary
These collaboration concepts are distinct from part-modeling vocabulary โ introduce them when the team is ready to work together on shared documents.
Version
A user-created snapshot or save point in the design process. Like a Git commit โ a named, timestamped checkpoint you can always return to.
Branch
A separate and parallel workspace to explore alternate designs without affecting the main model. Safe to experiment in.
Merge
Bring changes from one branch or version into the active workspace. Combines two lines of design work into one.
Workspace
An active and independent modeling space in an Onshape document. The main workspace is where your current live design lives.
Comment
Messages left inside a workspace in Onshape โ can include text, images, @mentions, and model tags to point reviewers to a specific part.
Compare
Visual representation of differences between versions or workspaces. Use to review what changed between design iterations.
Share
Allows other users to view, edit, or copy a document. Set sharing permissions carefully โ editors can make permanent changes.
Derived
Insert parts from one Part Studio into another in the same or different document. Key to multi-document robot design.
Discussion Questions
Getting Organized
What kinds of folders will your team need this season?
Do you have a team account to own all shared documents?
Have you created a team in Onshape under My Account → Teams?
Versions & Branching
What will be your team's versioning strategy โ when do you version?
When will you use branches, and who decides when branches can be merged?
Comments & Communication
What happens when a comment is assigned to someone โ who is responsible?
What response time do you expect on comments made in the document?
Large Assembly Organization
Based on your team's skill level, should you start with single-document or multi-document design?
If multi-document, who is responsible for maintaining references between documents?
What organization strategies make sense for your team, and which don't?
Official PTC/Onshape Resources
📚 Unit Guide โ PTC / Onshape
Collaboration
Full instructor guide: team setup, versioning strategy, branching, comments, Link Tab, OneIPM, and large assembly organization.