Creating and using labels

Onshape provides a way for you to group and label documents and publications to better organize them. You can label individual documents and publications or groups at a time. You can also relabel documents and publications, apply more than one label to a document or publication, remove a label, and add and delete labels at will. All labels are user-specific, and no other user sees the labels you apply to documents and publications, regardless of permissions.

You can also create folders to physically group documents or publications. Share permissions are applied to the folder (top-level folders only) and all documents, publications, and sub-folders within a folder inherit those Share permissions. For more information about folders, see Creating and Using Folders.

  1. Do one of the following:

    • Click Create > Label to create a label without immediately applying it to a document:
    • "Organizing documents"- example of creating labels for documents

    • Click the Create new label icon (Add label button icon) next to Labels (Label icon) in the filter list:

      Example of creating labels for documents

    • From a Publication or document on the Documents page, click the Labels icon (Label icon) to create, add, or edit labels for the selected document (shown in the first image below). The Details panel opens, where you can perform these label operations (shown in the second image below). Click the Create new label icon (Add label button icon):

      Create, add, or edit a label for the selected document Editing a label for a selected document

  2. The Create new label dialog opens:

    "Create new label" - example of the Create new label option

  3. Enter a name for the label and click Create.

The label appears in the filter list on the left side of the window.

Applying labels

You can apply one or more labels to one or more documents and publications at a time:

  1. In the Documents list, select one or more documents. Use Ctrl+click to select more than one document or publication.
  2. Do one of the following:
    • Right-click and select Labels from the context menu (first image below). Select which labels to apply to the document(s) and publications by checking the box next to the desired labels (shown in the second image below):

      Adding a label to multiple documentsAdding a label to multiple documents

    • Click and drag the documents and drop them on the label in the filter list:

      Adding a label to multiple documents

  3. Notice the label appear below the document or publication name and in the Details pane.

Use the Search box in the dialog to search for the label you want when applying labels to documents and publications.
To locate documents and publications with a particular label, select the label filter on the left side of the window.
You can also drag and drop selected documents and publications onto an existing label to apply that label.

You can also apply existing labels while creating a new document or publication:

  1. On the Documents page, click Create.

  2. From the dropdown menu, click Document (or Publication)

    Screenshot of New document dialog

  3. This opens the New document/publication dialog box (shown above), where you can supply a name and optionally apply existing labels.

Filtering by labels

To locate documents and publications by label, select the label in the filter list:

Locating Documents by label

The breadcrumb at the top of the list displays the current filter selection (or folder path). The list is refreshed to list all entities with that label applied.

Deleting labels

Deleting a label has no effect on documents or publications, except to remove the label from them:

  1. Select the label in the filter list.
  2. Right-click and select Delete label.
  3. In the message that appears, click Delete.

You can remove a label from a document or publication by selecting the entity and opening the Label dialog (click the Label icon in the toolbar) or right-click the entity and select Labels from the context menu. This opens the dialog with a list of labels: click the checkbox to remove labels from, or apply labels to, the selected entity.