This functionality is available on Onshape's browser, iOS, and Android platforms.
The Documents page is the first page displayed when you sign in to your Onshape account. The exception is that Enterprise subscription users will land on the Activity page when you sign in. When on any other page in the system, you can click the Onshape logo (or your company logo) to return to the Documents page.
This page lists all of the Onshape projects, folders, publications, and documents, you have any permission to, including just view permission. All Onshape entities missions that are applied automatically upon creation of the document. There's a great deal of flexibility in assigning and revoking permissions, so be sure to check out these topics for details: Share Documents (for everyone) and Understanding and Administering Project Roles and Permission Schemes (for Enterprise users and administrators).
This topic explains the anatomy of this Documents page, explains the tasks you can perform here, how to navigate it and gives a short explanation of using this page to organize and then locate your data using labels, folders, and in some cases projects, and through filters and search functionality.
The page layout is explained below, along with how to navigate and use the specific tools on the page. The platform-specific dropdowns present how to locate the functionality on each platform user interface, as they may differ slightly from each other.
Document page layoutCopy link
This section presents the basic functionality and constructs of the page, and the platform-specific topics below present how to use the functionality for each platform type.
The Documents page is customizable to help you view available documents, folders, and publications with ease. When you select a filter and layout preference, Onshape displays this page that way until you change them again. For example, if you select the List view and your company name filter, the next time you access the Documents page these settings will still be selected.
Documents page with a document selected and the preview visible in the Details flyout
Document thumbnails are of the last Part Studio opened, but you can customize this from within the Part Studio as well. The document name is in bold and the last opened workspace is in light grey beside it. The numerals below explain the matching areas of the Documents page pictured above:
- Onshape supplies various filters to sort documents into groups. The selected filter also appears above the list of documents (to the right of the Create button). For information on filters, see Using Onshape Filters.
- Regardless of which filter is selected, the top of the documents list displays those documents most recently opened by the current user (Last opened by me). This section is collapsible.
- Buttons for:
List view - Display the document list in list view (shown above).
Tile view - Display the document list in thumbnail tile view.
- List of projects (for Enterprise accounts), folders, publications, and documents. For more information on folders, see Creating and Using Folders. for more information on projects, see Understanding and Administering Project Roles and Permission Schemes.
- The Create button has multiple options:
Document - Click to create and name a new Onshape document and optionally apply an existing label. You can also create a new document using cad.onshape.com/new.
Folder - Click to create and name a new Onshape folder.
Publication - Click to create and name a new Onshape publication.
Import files - Click to import external files into Onshape.
Import from - Click to import files from Google Drive, Dropbox, or Microsoft OneDrive into Onshape.
Project - Click to open the Create new project dialog box, where you are able to specify the name, description, and permission scheme of your project, as well as who has access to it. This option is available for any user who has been granted the Global permission that enables this functionality.
Label - Click the Create new label icon (
) to create and name a new Onshape label.
The Create button is available for all users; however, when an enterprise user has read-only access to the folder in which they are trying to create, this button is inactive.
- The Details flyout
displays more details about the document. It can be toggled off with the Details button. Click this icon to toggle the flyout open and closed.
Click the Share details icon
to display the permissions on the document and the folder or project (if any) within which it resides.
Click the versions and history icon
to display the versions and history of the document. This panel allows you to perform all actions available through the Versions and history flyout in a document, right from this panel. For more information on how to use the Versions and history graph, see Document Management. You can hover over any entry in the graph and see the description as entered into the properties for that Version. For more information on properties, see Versions and History.
Click the Document name in any of the panels (Details, Share Details, or Versions and history). The Document opens in a new browser tab.
Hover over the Document name in any of the panels (Details, Share Details, or Versions and history). The Copy link icon
becomes visible. Click it to copy the document link to your clipboard.
When searching on Parts, Part Studios, Drawings, or Assemblies, specifically, the Detail pane for a selected document will include a Properties icon
:
Properties selected in the Detail flyout, above
Click this icon to view Properties information. Click the Edit link at the top of the pane to edit properties.
Also, if the search criteria and results include any revision history information (such as State), the Detail panel for a selected document will include a Revision history icon
:
Click this icon to view Revision history information. The revision of the selected part (in the search results) is highlighted in blue in the Revision history panel. For example, the selected Part 1 on the left above is highlighted on the right, under Revision history.
Any Categories added to the company or enterprise are also available in the Add criteria selection box in the Advanced search dialog (shown below).
Selecting and opening documents, folders, and publicationsCopy link
Selecting an item (document, folder, or publication) results in the item being highlighted in the list, and when the Details flyout is open, the Details of that item are displayed. Click anywhere in the tile or the table row to select an item. The background of the item name turns blue when selected.
By contrast, to open an item, click the actual item name either in the table or the tile. When you have the cursor positioned correctly, the item name is underlined.
Navigating documents, folders, and publications
You can use the arrow keys to navigate up and down the list of documents, folders, and publications.
You can select multiple documents, folders, and publications (or a mix among all 3):
- Use Ctrl+click to select more than one at a time.
- Use Shift+click (or Shift-arrow) to select a range.
Inline commands
You can use the following commands to the right of the document, folder, or publication:
-
Share - Share a private document, folder, or publication with other users, and assign permissions per user. Send an email link to any person. If they are an Onshape user, they can click the link and open the document in Onshape. If they are not yet a user, the document opens in View-only mode. For more information, see Share Documents.
-
Delete - When a document or folder is highlighted, you can use the Delete key to move the document to Trash, or click the Trash icon (shown in the image below):
To delete multiple documents/folders, select them using Ctrl+click or Shift+click (as outlined above), and click the Trash icon in the Details panel on the right:
-
Labels - Select labels to apply to the selected document(s). Labels cannot be applied to folders.
Context menu commandsCopy link
Select one or more documents, folders, or publications (or any mix among all 3), and right-click to access the context menu, with the following commands.
The available commands depend on the filter context, type of container (document, folder, publication), and number and mix of container type(s) selected.
- Open - Open the selected item.
- Open in new browser tab - Open the selected item in a new browser tab.
- Rename document/folder/publication - Provide a new name for the selected item.
- Copy workspace - Available only for documents; makes a copy of the document default workspace. If you have Edit permission on the folder, copies are placed in the same folder as the document being copied. If you do not have Edit permission on the folder, the copy is placed at the root level of your Onshape account.
After you copy a workspace, a pop up message will indicate the copy was successfully created and provide a link to the copied workspace. The link will open the copied workspace in a new tab.
- Details - Show the Details flyout for the selected item.
- Versions and history - Available only for documents; view a list of all the versions of a particular document. For more information, see Document Management.
- Labels - Select labels to apply to the selected document(s). Labels cannot be applied to folders.
- Share - Share a private document, folder, or publication with other users, and assign permissions per user. Send an email link to any person. If they are an Onshape user, they can click the link, and open the document in Onshape. If they are not yet a user, the document opens in View-only mode. For more information, see Share Documents.
- Move to - Move the selected item to a folder. You can also use drag and drop for this action.
- Transfer ownership - Transfer the ownership of the item to an individual or a company.
- Unshare with me - Available only if the selected item was shared with you; removes you from the item's share permissions.
- Make public - Available only for private documents; makes the document publicly available to all Onshape users in view-only mode.
- Send to trash - Move the selected item to trash. You can also drag and drop items in the Trash filter to delete them.
- Remove from recently opened - Available for documents and publications; removes the item from your Recently opened filter.
Once in Trash, an item can be Restored or Deleted (individually), or you can use the Empty trash button to delete all items from Trash at once.
The actions available to you may change based on permissions.
Thumbnail images and Detail pane sizeCopy link
To change the thumbnail that is displayed, open the document, right-click on the tab you wish to use as the thumbnail and click Select as document thumbnail. Keep the following in mind:
- If the tab selected is deleted or moved to another document, the thumbnail reverts to the most recently opened tab.
- Edit permission on the document is required in order to select a new thumbnail.
To adjust the size of the Details flyout and the documents list, place your cursor on the splitter bar between them, then click and drag either left or right. Keep in mind:
- The Details flyout can be resized no smaller than 340px.
- Once the Details flyout is resized, the new position of the splitter bar will be maintained when the flyout is opened again, and when the you sign in again.
While in the company filter (shown below in bold blue text), the top of the window displays thumbnails of the last documents opened by you (regardless of ownership). As many thumbnails are shown as will fit in the window at the time.
SearchingCopy link
Use the search bar at the top of the Documents page to search for a document within the active filter, as stated in the search bar:
Use the down arrow in the Search bar to activate an advanced search menu to search for an Onshape tab type (Document, Part, Part Studio, Assembly, Drawing, or all types) within the active filter and refine the search using additional relevant search criteria.
For more information on what additional search criteria may be used, see the topic Advanced search.
When using the search box to search for a document, the search is conducted within the currently selected filter
NotificationsCopy link
The upper-right side of the title bar includes a bell icon indicating notifications (when there are notifications). A number beside the icon indicates unread notifications. Notifications are automatically deleted after 14 days, whether they are read or not.
Notifications may include:
- A comment on the document - Open to read and mark as read
- Status of an upload - Open to read (mark as read, or delete)
- Status of an export - Open to read (mark as read, or delete)
- Workspace status - If the workspace falls out of date with the most current Onshape release, it is noted here. An out of date workspace could be the result of:
- Branching from a version created before the last update
- Restoring to a version created before the last update
Information about updating is displayed.

The Document page on the iOS platform has the same functionality as the web platform. For example, you can click the Details icon at the right end of a document listing to open the Details pane.
In the first image above, an example of the iOS Documents page on an iPhone. In the second image above, an example of the iOS Documents page on an iPad in horizontal position, shown in grid view.
iOS Details pane for a document on an iPhone (above)
iOS Documents page (in list view) and Details pane for a document on an iPad in vertical position (above)
The Documents page can be filtered for ease of finding documents. Click the side panel menu button in the upper left corner of the page to open the side panel menu and navigate through your Onshape Documents. Once you select a filter, tap away from the menu (or, in horizontal position, tap on the menu icon again) to close it. You can also view your Profile and Notifications from this menu:
iOS side panel menu shown on an iPad in vertical position
When accessing the Documents page on a mobile device, you have the option to choose between Grid view or List view. Click the menu button in the top right corner of the page (shown below) to set your preferred view. Onshape remembers your settings.
To access the Details pane on an iPad, click the Details icon on the right side of the page. The Details pane remains open while you continue to browse through documents. To close the Details pane on an iPad, click the Details icon
again.
To close the Details pane on an iPhone, tap the X in the upper right corner.
Tap the Share details icon to display the permissions on the document and the folder or project (if any) it resides within.
Tap the versions and history icon to display the versions and history of the document, and also opens the document. This panel allows you to perform all actions available through the Versions and history flyout in a document. For more information on how to use the Versions and history graph, see Document Management.
Tap the Edit icon (the pencil icon) at the top-right of the pane to rename the document.
Tap the History icon to open the document, and also open the History pane for that document.
Tap the Copy icon to make a copy of the document; you are prompted to name it, and the copy opens automatically.
Tap the Move icon to select a folder to which to move that document.
Tap the Trash can icon to move the document to trash.
Creating a new document
To create a new document:
Tap the button in the lower right:
From the menu, select Document.
Enter a title for the document, then click Create.
If you are a member of a company, you can select a document owner when you create a new document. If you are a member of a company, the default owner of a new document is the company that you are a member of. If you are not a member of a company, the default owner of a new document is you.

To import a file into Onshape:
Tap the button in the lower right corner, to the left of the new document button.
If you are a member of a company then when you import a new document, you can select a document owner. If you are a member of a company, the default owner of a new document is the company that you are a member of. If you are not a member of a company, the default owner of a new document is you.
For more info, see Import.

To export a file out of Onshape:
-
Tap the tab from which you want to export (Part Studio, Assembly, etc).
-
From the context menu, select Export.
-
Select an export file format:
-
Parasolid
-
ACIS
-
STEP
-
IGES
-
PVZ
-
JT
-
Collada
-
GLTF
-
OBJ
-
3MF
-
STL
-
-
Specify a name for the export file.
-
Select a version (if available)
-
Specify the export mechanism:
-
Download
-
Download and store file in a new tab
-
Store file in a new tab
-
-
Tap Export to export the file, or Cancel to close the dialog without exporting.
For more info, see Exporting Files.

To access your Onshape account settings:
Tap the icon in the upper left to access the navigation drawer. Here, you can select Account settings and then select from:
- Profile - View your name, username, nickname, edit your bio, and view the companies and teams you are a part of.
- Emails - View the email addresses you have associated with your Onshape account.
- Preferences - View and set the default units for Length, Angle, and Mass.
- Subscription - View your Onshape subscription type.
- Teams - View the teams you are a part of.
- Companies - View the companies you are a part of.
Sign out
To sign out of Onshape:
Tap the icon in the upper left to access the navigation drawer. Here, tap Sign out.

To provide feedback, watch videos, and access the help:
Tap the Help icon in the upper right:
From here you can tap to access:
- Help - the Mobile Help.
- Contact Support - Ask a question or provide feedback to Onshape in the form of logging a bug or requesting an improvement.
- About - See what version of Onshape your device is running and view Terms and Privacy.

To view the document information panel and access things like the document history, versions, etc:
Tap the icon to the right of the document:
From here you can:
- Access the document versions - see Version Manager for more info.
- Access the document history - see Version Manager for more info.
- Copy, delete, and share the document - see Share for more info on sharing documents.
- Add or edit the document name and document description - tap the icon in the upper right of the document info panel to edit the document name:
Tap Add description to add or edit the document description.
If you are not the owner of a document you can not delete it. However, if you have a document shared with you, the option to remove yourself from the document is available. Tap Remove to remove yourself, or unsubscribe, from the shared document.

The Documents page is the first page displayed upon sign in. While within a document, tap the back arrow in the upper left corner to return here.
The Documents page can be filtered for ease of finding documents. For example, your company name filter (see "Fishbowl" in the image below) displays the root level of your account, displaying your available filters:
To create a new document:
Tap the button in the lower right.
Enter a title for the document and toggle on Public, or leave the toggle off for Private.
If you are a member of a company, when you create a new document you can select a document owner. If you are a member of a company, the default owner of a new document is the company that you are a member of. If you are not a member of a company, the default owner of a new document is you.

To import a file into Onshape:
Tap the Plus sign button in the lower right corner of the Documents Page, and then the Import button.
If you are a member of a company, when you import a new document you can select a document owner. If you are a member of a company, the default owner of a new document is the company that you are a member of. If you are not a member of a company, the default owner of a new document is you.
For more info, see Import.

To export a file out of Onshape:
-
Tap the tab from which you want to export (Part Studio, Assembly, etc).
-
From the context menu, select Export.
-
Select an export file format:
-
Parasolid
-
ACIS
-
STEP
-
IGES
-
PVZ
-
JT
-
Collada
-
GLTF
-
OBJ
-
3MF
-
STL
-
-
Specify a name for the export file.
-
Select a version (if available)
-
Specify the export mechanism:
-
Download
-
Download and store file in a new tab
-
Store file in a new tab
-
-
Tap Export to export the file, or Cancel to close the dialog without exporting.
For more info, see Exporting Files.

Share Notifications
To turn on Share Notifications (a push notification whenever a user shares a document with you):
Tap Settings at the bottom right. Select My Account and toggle Share Notifications on (box checked) or off (box empty).
Comment Notifications
To turn on Comments Notifications (a push notification whenever a user comments on a shared document):
Tap Settings at the bottom right. Select My Account and toggle Comment Notifications on (box checked) or off (box empty).
Sign out
To sign out of Onshape:
Tap the icon in the upper left to access the navigation drawer. Here, tap Sign out.

To provide feedback, watch videos, and access the help:
Tap the Help icon in the upper right.
From here you are able to tap to access:
- Help - the Mobile Help.
- Contact Support - Ask a question or provide feedback to Onshape in the form of logging a bug or requesting an improvement.
- About - See what version of Onshape your device is running and view Terms and Privacy.

To view the document information panel and access things like the document history, versions, etc:
Tap the icon to the right of the document.
From here you can:
![]() |
Access the document versions - see Version Manager for more information. |
![]() |
Access the document history - see Version Manager for more information. |
![]() |
Copy the document - make a copy of the document. |
![]() |
Move the document - see Folders for more information on moving documents. |
![]() |
Delete the document - Move the document to trash. |
![]() |
Remove yourself from document - see Share for more information. |
![]() |
Share the document - see Share for more information. |
![]() |
Add or edit the document name and document description - tap the icon in the upper right of the document info panel to edit the document name, tap the icon |
If you are not the owner of a document you can not delete it. However, if you have a document shared with you, the option to remove yourself from the document is available. Tap Remove to remove yourself, or unsubscribe, from the shared document.
For an additional Learning center resource, follow the learning pathway course here: Document Management (Onshape account required).