How To Import In Onshape: The Complete CAD Translation And Setup Guide

To import CAD models and 2D data into Onshape, click the Create button on the Documents page and select Import Files, or click the Add element menu (the plus icon) at the bottom-left of an active Document. Choose your target file, configure translation preferences like axis alignment and geometry splitting, and let Onshape's cloud engine convert the data into native Part Studios or Assemblies. Maintaining proper export formats such as STEP or Parasolid ensures high-fidelity translation without broken faces or missing references.

Pre-Import Requirements: Supported File Formats and Workspace Prep

Successful data translation begins before you ever click the import button. Because Onshape is a fully cloud-native CAD platform, its translation engine processes imported files using cloud-based servers, converting proprietary or neutral formats into Onshape’s database-driven geometry representation. Understanding which file types translate best and preparing your local files will prevent geometric degradation, broken assemblies, and downstream modeling errors.

To ensure your CAD data translates seamlessly without geometry errors, verify your files and environment against this pre-import checklist.

Essential System & File Checklist

• Primary Supported Neutral Formats: Parasolid (.x_t, .x_b) which is Onshape's native kernel, STEP (.step, .stp) AP203, AP214, and AP242, IGES (.iges, .igs), and JT (.jt).
• Supported Native CAD Formats: SolidWorks (.sldprt, .sldasm up to current version), Autodesk Inventor (.ipt, .iam), PTC Creo (.prt, .asm), Catia v5/v6, Solid Edge (.par, .asm), and Rhino (.3dm).
• Supported 2D Vector Formats: DXF (.dxf) and DWG (.dwg) for sketches, sheet metal profiles, and drawing imports.
• Supported Mesh Formats: STL (.stl), OBJ (.obj), and 3MF (.3mf) for reference geometries or 3D printing preparation.
• Prerequisite Setup: A stable internet connection with minimum upload bandwidth of 5 Mbps to prevent packet loss during large multi-gigabyte assembly uploads.
• Administrative Clearance: Ensure you have "Can Edit" permissions on the target Onshape Document if importing into an existing collaborative workspace.
• Time & Size Constraints: Expect 30 seconds to 5 minutes of cloud processing time per 100MB of geometric data. Single file uploads through standard web browsers are capped at 5GB, although assemblies of this size should be compressed into zipped archives first.

Step-by-Step Onshape Data Import Workflow

Step 1: Clean and Consolidate Source CAD Data

Before exporting from your legacy CAD software, run diagnostics on the source geometry. Open models in their native system to check for open surfaces, zero-thickness geometry, or corrupt features in the history tree. If importing an assembly, make sure all referenced sub-assemblies and individual parts are saved in the same directory.

If you are importing native CAD assemblies like SolidWorks or Inventor, compress the entire assembly folder into a single ZIP file. The top-level assembly file must have the exact same name as the ZIP container, or you must explicitly specify the top-level master file during the upload stage.

Warning: Importing native assemblies without their corresponding part files will result in empty assembly structures in Onshape. Always package your assembly using a packaging utility like SolidWorks "Pack and Go" before zipping and importing.

Step 2: Select Your Import Entry Point

Onshape provides two distinct entry points for importing data, depending on whether you want to generate a brand-new Document or insert geometry into an active workspace.

To import as a new, standalone Document:

1. Log in to your Onshape account and navigate to the Documents page.
2. Click the blue Create button in the top-left corner.
3. Select Import files... from the dropdown menu.
4. Browse your local file system, select your CAD file or zipped assembly package, and click Open.

To import into an existing, open Document:

1. Open the Onshape Document where you want the imported geometry to reside.
2. Click the + (plus) icon located in the bottom-left corner of the interface (the element tab bar).
3. Select Import... from the contextual menu.
4. Select your file from your system dialog. This action uploads the file directly into the Document as a new tab, creating corresponding Part Studios or Assemblies based on your translation settings.

Step 3: Configure Cloud Translation Settings

Once you select your file, Onshape opens an import options dialog box. Correctly configuring these choices prevents distorted coordinate systems and messy workspace layouts.

[Import Options Dialog Configuration] ├── Import to: │ ├── Single document (best for single parts) │ └── Combined document (best for complex assemblies) ├── Orientation: │ ├── Y Axis Up (Standard for legacy CAD like SolidWorks/Inventor) │ └── Z Axis Up (Standard for architectural/3D printing & Onshape default) └── Assembly options: ├── Import as single Part Studio (flattens assembly hierarchy) └── Import as assembly with Part Studios (retains functional mating groups)

1. Import to: Choose whether to import the file as a single Document containing multiple tabs or split components across different files.
2. Orientation Alignment: Onshape uses a Z-Axis Up coordinate system. If your source file was designed in a system that uses Y-Axis Up (such as SolidWorks or Autodesk Inventor), check the box for Orient import with Y Axis Up to automatically rotate the model 90 degrees. This ensures your front, top, and right default planes align correctly with Onshape's system.
3. Assembly File Handling: If importing an assembly, decide if you want to Import as a single Part Studio or Import as an Assembly and Part Studios. Choosing "single Part Studio" merges your components into one environment as separate bodies, which is ideal for reference geometry. Choosing "Assembly and Part Studios" preserves the hierarchical structure and creates an Assembly tab with individual linked parts.
4. Create Composite Parts: Check this option if you are importing complex models with thousands of surface bodies that you want grouped into a single manageable unit.
5. Allow Import of Faulty Entities: Check this box if you want to import models even if they contain minor geometric errors, allowing you to use Onshape's healing tools to repair them post-import.

Pro-Tip: If you are importing highly detailed parts for reference only and do not need to modify their geometry, check the Import as Composite Part box. This vastly speeds up browser rendering times and keeps your Feature List clean.

Step 4: Monitor Translation Status and Verify Geometry

Once you click Import, Onshape starts background processing. A notification banner appears in the upper right-hand corner showing the translation progress.

1. Wait for the green notification banner indicating "Translation complete."
2. Open the newly created tab (it will be named after your imported file).
3. Inspect the model for missing faces or invalid edges. Onshape highlights problematic geometry with a red warning in the Feature List.
4. To check if the import succeeded without geometry errors, right-click the imported feature in your Part Studio's Feature List and select Show import diagnostics. This tool scans the model and highlights any open sheets or faulty faces that require healing.

Onshape File Format Translation & Behavior Reference

Selecting the correct file extension determines how much metadata, assembly hierarchy, and visual modeling detail transfers into your Onshape workspace. The table below outlines how different CAD and vector formats behave during the cloud import process.

Common Translation Failures & Geometry Correction

Despite Onshape's advanced translation engine, corrupted source files, incompatible coordinate systems, or file structural errors can lead to importing failures. Below are the most common real-world failure modes and instructions on how to repair them.

Scenario A: Imported Model is Empty or Missing Solid Bodies

• Root Cause: The imported model consists of unjoined surface patches (sheets) rather than a stitched, water-tight solid volume. If the source model had open boundaries, Onshape imports it as a collection of surface bodies rather than a solid part.
• Actionable Fix: Right-click the import tab and select Show import diagnostics. If open boundaries are detected, use the Fill or Replace Face tools in your Part Studio to close any gaps. Alternatively, use the Bridging Curve and Loft tools to patch holes, and then apply the Enclose feature to convert the closed boundary volume into a solid 3D part.

Scenario B: Zipped Assembly Imports with Zero Sub-Components

• Root Cause: The master assembly file inside the ZIP package was named differently than the ZIP file wrapper, or the internal path references point to absolute directories on a local physical drive rather than relative folders.
• Actionable Fix: Ensure all parts and sub-assemblies reside in a single flat directory with no nested sub-folders. Re-create the ZIP file so its name perfectly matches the main .sldasm or .iam top-level assembly file. When importing, select the option to explicitly designate the top-level assembly file in the Onshape file configuration prompt.

Scenario C: Imported DXF/DWG Sketch is scaled incorrectly

• Root Cause: The 2D vector file lacks unit metadata, causing Onshape to default to the Document's baseline system units (usually inches or millimeters) regardless of the scale used when creating the original drawing.
• Actionable Fix: When importing a DXF or DWG as a sketch inside an active Part Studio, click the Insert DXF or DWG tool in the Sketch toolbar. Before selecting the file from the list, look at the dropdown menu for Units of imported file and manually select the scale (e.g., Inches, Millimeters, Meters) used in the original source program.

Scenario D: Mesh Import is Locked and Cannot be Edited with Standard Feature Tools

• Root Cause: Mesh files like STL or OBJ are tessellated formats composed of flat triangular facets instead of smooth mathematical boundary representations (B-Reps). Standard parametric CAD tools like Extrude, Fillet, and Chamfer cannot natively select or modify faceted triangles.
• Actionable Fix: Use Onshape's Mixed Modeling tools. You can reference mesh vertices to construct sketch planes, construct axes, and create native parametric geometry around the mesh. If modification is required, use the Facet toolset to simplify, split, or transform the mesh structure, or use the Boolean tool to combine native solid parts directly with the mesh.

Frequently Asked Questions

Can I import SolidWorks files with their original feature history?

No. No modern CAD platform can import feature trees (sketches, extrusions, fillets) from a rival proprietary CAD system because every software engine processes parametric history in a different sequence. SolidWorks files import into Onshape as precise boundary representation (B-Rep) solids, but you can edit them after importing using Onshape's robust Direct Editing tools (such as Modify Fillet, Move Face, and Delete Face).

How do I import a DXF directly into an active sketch?

First, open your Document, enter an active sketch, and click the Insert DXF/DWG icon on the sketch toolbar. Click the Import option at the bottom of the pop-up pane to upload your local DXF file. Once uploaded, select the file from your Document's available media lists, set your target unit scale, and click to place it onto your active sketch plane.

What is the maximum file size Onshape can translate?

Onshape's web portal supports importing single files up to 5GB in size. However, for assemblies and parts exceeding 500MB, it is highly recommended to use simplified STEP or Parasolid configurations rather than native files to cut down on translation times and avoid consuming excessive browser memory during rendering.

Why does my imported model look faceted and low-resolution?

This happens when you import a mesh-based file like STL or OBJ rather than a solid CAD format. Mesh files represent curved surfaces using flat triangular plates. To resolve this, ask the creator of the source CAD file to export the model in a vector/solid format like STEP or Parasolid instead of an STL.

How can I change the units of an imported part?

If your imported model is scaled incorrectly, you can adjust it by clicking the Workspace units menu (the three horizontal lines next to the Onshape logo in the top-left corner) and changing the default units. To scale the physical size of the geometry, use the Transform feature, select your imported part, change the transform type to Scale, and enter your desired scaling factor.

Ready to Optimize Your Cloud CAD Workspace?

Moving your historical CAD library into Onshape's secure cloud database dramatically simplifies team collaboration and speeds up development cycles. Create a free Onshape Professional trial today to experience premium translation speeds and secure collaborative assembly design.