Chapter 10

Organization & Collaboration

πŸ“– About 25 minutes 🎯 3 checkpoints
0 / 3 steps completed

Copy the Document

As before, start by copying the tutorial document to your own Onshape account.

Copy collaboration document
Copy the collaboration document to your account
Open Tutorial Document

Click to open the Onshape tutorial document in a new tab, then copy it to your account

A. Getting Organized

Create a team
Go to My Account β†’ Teams to create a team and add members

Create a Team

Create a team
Create a team in My Account β†’ Teams and invite members

Onshape lets you create teams to manage permissions centrally. Go to My Account β†’ Teams and enter your teammates' emails to invite them. When sharing documents later, you can share with the entire team instead of adding people one by one.

Folder management
Organize documents into folders by subsystem

Folder Management

Create folders
Create folders in Onshape to organize documents by subsystem

As your project documents grow, organizing them into folders becomes important. A recommended approach is to organize by subsystem:

Organizing Within a Document

Within the same document, use Tabs to organize different parts and assemblies. Give each tab a clear name (e.g., "Drivetrain Assembly", "Wheel Part Studio") so teammates can find what they need easily.

Ownership and Sharing

Share document
Share documents with team members, setting edit or view-only permissions

The document owner controls who can edit and who can only view. Set permissions carefully to prevent teammates from accidentally modifying critical designs.

βœ…
Checkpoint 1: Have you created a team and set up a folder structure?

Confirm you've created a team in Onshape, invited teammates, and established a folder structure organized by subsystem.

B. Versions and Branching

Create versions and branches
View versions in the history graph and create branches from versions

What is a Version?

A Version is like a game save -- it takes a snapshot of your design's current state that you can revisit anytime. Versions are read-only and can't be modified.

How to Create a Version

Change part color
Make some changes to the design, such as changing a part's color
  1. Make some changes to the design (e.g., change a part's color)
  2. Click the document menu in the top left β†’ Create version
  3. Give the version a name (e.g., "Pre-competition version")
  4. View all versions in the History graph
Create version
Click document menu β†’ Create version to take a snapshot of your design

When to Create a Version

What is a Branch?

A Branch is an independent workspace created from a version. You can experiment with new ideas in a branch without affecting the main design. If you're happy with the results, merge it back into the main workspace.

Creating and Using Branches

Create a branch
Create a branch from a version to start independent design experiments
  1. Create a branch from a version
  2. Make changes independently in the branch
  3. If satisfied, merge back to main; if not, simply abandon the branch
Oscillating intake system
Experimenting with an oscillating intake system design in a branch
Change dimension
Modify part dimensions in a branch without affecting the main design
Compare branches
Compare the branch and main workspace to see specific changes
Merge branch
Merge the branch back into the main workspace when satisfied
βœ…
Checkpoint 2: Have you created a version and a branch?

Confirm you can see the version you just created in the history graph, and that you successfully created a branch from that version.

⚠️ Common Issues

  • Can't find version history? β€” Click the document menu in the top left β†’ History to see the timeline of all versions and changes.

C. Comments and Communication

Comments and import features
Leave comments on the model and import external files

Comments

Onshape supports leaving comments directly on models. You can:

Tasks and Notifications

Mark comments as Tasks and teammates will receive notifications. Mark them as resolved when done.

Filtering Comments

When comments pile up, filter them by type: tasks, resolved, or unresolved.

Importing External Files

Need parts designed in other software? Onshape supports importing multiple formats:

Link Tab

Embed external links in your document -- such as game manuals, design documents, or team journals. Keep all related materials in one place.

βœ…
Checkpoint 3: Have you tried leaving a comment on the model?

Leave a comment on the model and try @mentioning a teammate. Comments are an important way for teams to communicate.

What You Learned in This Chapter

  • Create Teams to manage permissions centrally
  • Versions snapshot your design; Branches let you experiment with new ideas
  • Comments and @mentions enable team communication
← Previous: Final Assembly Next: Large Assemblies β†’