Advanced teams rarely model the same family of parts twice. The tools are parametric variables and configurations, and choosing the right one is a design-intent decision.
Parametric variables live as features in the Part Studio (#track, #centerDist, #web). They drive geometry within one design and are unit-sensitive. They are perfect when you want a single part that resizes — change #centerDist and the gearbox plate's bores move together. They do not create separate selectable variants; there is one part whose dimensions you tune.
Configurations create named variants of the same Part Studio or Assembly — e.g., a side plate in 'short', 'medium', 'long' lengths, or a swerve mount for MK4i vs MK4n. Each configuration is a distinct selectable option, and configuration variables can be enforced with default/min/max limits and are accessible across tabs and documents. You can mix configuration inputs (a dropdown like motor = NEO/Kraken) with configuration variables (a numeric like length = 6/8/10 in). The Onshape rule of thumb: use a parametric variable when there is one design that flexes, and a configuration when you need discrete, named alternatives that coexist.
Worked example — a configurable gearbox plate. Build the single-stage plate from Mini-Project 2 with a configuration input motor (NEO / Kraken X60 / Falcon 500). Drive the bolt pattern from the configuration so each option lays down the correct footprint. Add a configuration variable ratio that swaps the gear teeth (and thus #centerDist). Now one Part Studio yields every gearbox your team needs, and the BOM lists exactly which configuration each instance uses.
Worked example — passing values between studios. When a configured sketch needs to drive a downstream Part Studio, instantiate the configured sketch into the destination and pass the configuration value through. This keeps a family of mounts in sync with a single source of truth.
Pitfall: configurations multiply quickly. A 3-option motor × 3-option ratio × 2-option length = 18 variants; only the ones you actually instantiate get computed, but the table can get unwieldy. Keep configuration tables small and meaningful, and reach for a FeatureScript (next lesson) when the logic is more complex than a table can express.
Key takeaways
- Parametric variables = one design that flexes (unit-sensitive, Part-Studio-local); configurations = discrete named variants that coexist across tabs/documents
- Combine configuration inputs (dropdowns like motor type) with configuration variables (numeric like length/ratio) to build whole part families from one studio
- Keep configuration tables lean and escalate to FeatureScript when the logic outgrows a table
Keep going
Take the quiz · +10 XP with an accountMore in Advanced Techniques & Case Studies
Sources & corrections
This lesson is AI-assisted: drafted from primary sources, then reviewed and edited by hand. Errors still get through. When one is reported we fix it and write down what changed — publicly, in the corrections log.
Sources and further reading
- Onshape Tech Tip — Parametric vs. Configuration Variablesonshape.com
- Onshape Help — Configurationscad.onshape.com
- FRCDesign.org Learning Coursefrcdesign.org
Read next
Articles on this, for competition day
The lesson covers how it works. These cover what to do when it breaks.
- 8 min read
FRC Motors Compared: NEO vs Kraken X60 vs Falcon 500 vs NEO Vortex
Compare FRC brushless motors: REV NEO, NEO Vortex, Kraken X60, and Falcon 500. Exact specs, FOC explained, and which motor to pick for drivetrain vs mechanisms.
Read - 16 min read
FRC Elevator and Arm Design: Staging, Rigging, Motors, Gravity, and Safety
A primary-source FRC guide to designing elevators and arms: cascade vs continuous rigging, staging, motor and gear-ratio sizing, gravity math, and safe holding.
Read - 15 min read
How to Design an FRC Intake: Rollers, Compression, and Motors
A primary-source FRC intake design guide: over-the-bumper vs under-bumper, roller vs wheel, compliance and durometer, compression and wrap, and motor selection.
Read
Lesson quiz
RequiredAll 3 right completes the lesson. Miss one and only that question comes back — anything you already answered correctly stays banked.
0 of 3 answered
01.In Onshape, where can a configuration variable be referenced that a parametric (Part Studio) variable cannot?
02.Why does a parametric variable in Onshape reject an equation that returns a bare number where a length is expected?
03.What is the primary purpose of using configurations (rather than a single parametric variable) for an FRC part?
Answer every question to submit.
All 31 lessons in CAD & Design
- Not started:Configurations vs. Parametric Variables: Designing One Model, Many Robots
- Not started:FeatureScript Automation for FRC
- Not started:Browser-Based FEA: Weight-Optimizing Real Structures
- Not started:Swerve System Geometry & Motion Math
- Not started:Case Study: FRC 6328's Modular Gusset-and-Tube Methodology