The total estimated time of completion is 50 minutes.

Use this primer to become familiar with Onshape's terms, tools, and some of the more common workflows that Onshape has re-engineered to be simpler and more powerful than other systems. This primer steps you through setting up your Onshape profile, understanding the user interface, and the basics of creating and assembling parts. In many lessons, at the left of the screen are some helpful tips that are useful; refer to them at any time. At the top of all the lessons, there is an estimated time of completion right above the description of the lesson.

You can step through one lesson at a time, in sequential order, or use this list to jump to your preferred starting place. We recommend starting from the beginning so you don't miss any important information.

Before you start the Primer, there are some things that are worth knowing.

Onshape supports these browsers:

  • Google Chrome
  • Mozilla Firefox
  • Safari (Mac OS only)
  • Opera

Internet Explorer is currently not supported.

Supported Android versions

  • Lollipop (5.0, 5.1)
  • Marshmallow (6.0)
  • Nougat (7.0)
  • Oreo (8.0)
  • Pie (9.0)
  • Android 10

Onshape minimally requires Lollipop (5.0).

To check what version of Android your device has installed, go to your settings and check the About or General section.

Graphics Performance

Devices with older GPUs and older implementations of OpenGL ES 2.0 sometimes lack the necessary capabilities to run Onshape's 3D graphics. This most often happens on devices with a Mali 400 GPU.

When using devices with older GPUs or implementations of OpenGL ES 2.0 an error message will alert you when you open a Part Studio or an Assembly. The error message offers a link to more information as well as a link to continue.

If you elect to proceed after receiving the error message, you will likely notice graphics glitches or a blank, white screen. Eventually, the app may crash.

Why doesn't it work?

The Onshape graphics library uses Vertex Array Objects (VAOs). VAOs are supported natively in OpenGL ES 3.0 and above, but are not supported in the OpenGL ES 2.0 library. Often, implementations of OpenGL ES 2.0 contain extensions that support VAOs, but the support of these extensions is not guaranteed by Android and depend on the service of the manufacturer.

By default, Onshape allows a device with OpenGL ES 2.0 or higher to install the application but it is not until the app is running on a device that it can detect if the device has the necessary capabilities or extensions.

How can I fix this?

Use a device that supports, at the very least, OpenGL ES 2.0 with Vertex Array Object extensions.

A device running the latest version of Android does not necessarily support OpenGL ES 3.0. We recommend that you avoid running Onshape on devices with a Mali 400 or Mali 450 GPU, as these are unable to render 3D graphics properly.

It is recommended that you use a device that runs OpenGL ES 3.

How do I find out what GPU I have?

The most direct way to find out what GPU your device uses is to search for your device and/or serial number on the Internet. For example; you might try browsing or searching for your device on a website such as gsmarena.com or phonearena.com.

Supported iOS versions

Onshape minimally requires the latest version of iOS 16 or iPadOS 16.

To check what version of iOS your device has installed, go to Settings > General > About > Version.

Supported iOS devices

  • iPhone 8 and above
  • iPhone SE (2nd generation and above)

  • iPad Mini (5th generation and above)
  • iPad Air (3rd generation and above)
  • iPad Pro (1st generation and above)

If you'd like to bookmark Help pages on the iOS platform, you can use your app settings on your iOS device and set Open Help in browser to on. When you access the help via Onshape, it will then open in a browser, where you can create bookmarks of specific topics or pages.

Onshape supports keyboard shortcuts and mouse support when using peripherals.

We suggest that you run the 64-bit version of browsers on operating systems that can run both 64-bit and 32-bit (for example Windows, Linux).

Context menus are everywhere

Use a right mouse button (RMB) click on an entity to invoke its context menu. Context menus contain commands for that entity in the current context. Context Menus exist for entities in the graphics area, entities in Feature lists, Parts lists, and Drawings, as well as Onshape constructs such as tabs. Right-click throughout the interface to discover Context Menus.

View cube and view tools

Change the view of your workspace inside a Part Studio or Assembly with the View cube. Click the View cube, located in the upper right corner of the graphics area, to chose from a list of different viewing options. Select one to change your view of the graphics area or to change the view settings of your entities.

Use the smaller cube below the View cube to access the View tools which allow you not only shortcuts to standard model views like isometric, Dimetric and Trimetric, but also contains commands to display the model in various visual ways, observe Zebra stripes (Under the Curvature visualization menu), Draft analysis, and Apply section views.

See View Navigation and Viewing Parts for more information on different views.

Contact Support tool

Click Contact Support (if you have a professional subscription) or Report a bug (if you have a free subscription), located in the Help icon drop down or along the side of our Documentation topics to provide feedback, report bugs, and contact support.

Contact support dialog


For additional Learning center resources, follow the self-guided course here: Self-Guided Onshape Bootcamp (Onshape account required). You can also follow this self-paced course: Introduction to Parametric Feature-Based CAD (Onshape account required) and register for:Navigating Onshape (Onshape account required). You can also view the technical briefing article here: Navigating Onshape for New Users (Onshape account required).