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.
the part worth keeping
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
CAD & DesignAdvanced Techniques & Case Studieslesson 1 of 5
Keep going
Take the quiz+10 XP with an accountMore in Advanced Techniques & Case Studies
where this came from
Sources and 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, in public, in the corrections log.
sources and further reading
- onshape.comOnshape Tech Tip — Parametric vs. Configuration Variables
- cad.onshape.comOnshape Help — Configurations
- frcdesign.orgFRCDesign.org Learning Course
clipped to this lesson
Articles that go further on this
The lesson gets you through the topic. These go wider on it, and they read in one sitting.
- 8 min readFRC Motors Compared: NEO vs Kraken X60 vs Falcon 500 vs NEO VortexCompare 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./blogread it
- 16 min readFRC Elevator and Arm Design: Staging, Rigging, Motors, Gravity, and SafetyA primary-source FRC guide to designing elevators and arms: cascade vs continuous rigging, staging, motor and gear-ratio sizing, gravity math, and safe holding./blogread it
- 15 min readHow to Design an FRC Intake: Rollers, Compression, and MotorsA primary-source FRC intake design guide: over-the-bumper vs under-bumper, roller vs wheel, compliance and durometer, compression and wrap, and motor selection./blogread it
answer sheet
Lesson quiz
All 3 right completes the lesson. Miss one and only that question comes back, anything you already answered correctly stays banked.
0 of 3 answered
01In Onshape, where can a configuration variable be referenced that a parametric (Part Studio) variable cannot?
02Why does a parametric variable in Onshape reject an equation that returns a bare number where a length is expected?
03What 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 & Designopenclose
01 / prerequisites
02 / getting-started-cad-and-the-design-process
03 / onshape-fundamentals
04 / vendor-libraries-mkcad-featurescripts
05 / manufacturability-drawings-bom-design-reviews
06 / worked-examples-mini-projects
07 / common-mistakes-troubleshooting
- Not read yet:Mate & Assembly Failures: Why Parts Float, Spin, or Won't Move
- Not read yet:Broken In-Context & Derived References
- Not read yet:Slow Regeneration in Big Drivebase Assemblies
- Not read yet:Manufacturability Mistakes That Become Scrap
- Not read yet:Version Control & Team Collaboration Disasters
08 / advanced-techniques-case-studies
- Not read yet:Configurations vs. Parametric Variables: Designing One Model, Many Robots
- Not read yet:FeatureScript Automation for FRC
- Not read yet:Browser-Based FEA: Weight-Optimizing Real Structures
- Not read yet:Swerve System Geometry & Motion Math
- Not read yet:Case Study: FRC 6328's Modular Gusset-and-Tube Methodology