๐Ÿ”„ CAD ยท Onshape ยท Intermediate

Version Control & Design History

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:

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
v1 v2 v3 v4 MAIN experiment โ€” pneumatic intake merge if it works initial branch here continue

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:

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
๐ŸŽ“ VEX Course โ†’ ๐Ÿค Robotics Curriculum โ†’
⚙ 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.
For Coaches & Mentors
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.
🔗 PTC Resource Center →
🎓 Learning Center โ€” 4 Courses
Versions, Branching & Docs
Document History & Versions ยท Branching & Merging ยท Document Management ยท Master Model.
🔗 Start Course →
🛠 OneIPM
Project Management in Onshape
Project management embedded directly in Onshape. Free access for FIRST robotics teams โ€” assign tasks, track progress inside your CAD document.
🔗 Get Started →
← ALL GUIDES