Available in: Part Studio, Assembly

Shortcut: Ctrl+m

Shortcut: k (to show/hide mate connectors)

Mate connectors are local coordinate system entities located on or between sketches, parts, curves, or surfaces in Part Studios and on or between entities in assemblies. They are used within a mate to locate and orient sketch, part, curve, or surface instances with respect to each other.

Two part or surface instances are positioned in an assembly by creating a mate. The two instances are positioned by aligning a mate connector defined on one instance with a mate connector defined on the other instance.

The Z-axis of a mate connector can be used for Features that require the selection of an axis.

Mate connectors can be defined explicitly or implicitly:

  • Explicit mate connectors:
    • Defined using the Mate connector tool in the toolbar in an Assembly or in a Part Studio
    • Listed at the highest level in the Feature list
    • Can be selected from the Feature list during the creation of a mate
  • Implicit mate connectors:
    • Defined while creating a mate, in an assembly and some features in a Part Studio
    • Listed at a sub-level in the Feature list in an assembly, beneath the mate in which it is used
    • Cannot be selected from the Feature list during the creation of mate
    • Can be created while editing other features

When a mate connector is used in more than one mate, it is listed only once in the Feature list, with the first mate that uses it (if implicit) or as its own original top-level feature in the list.

Use the shortcut key k to hide/show mate connectors.

To learn more about mates, see Mates. To learn about mates and mate connectors, watch the video below.

Let's take a look at adding mates to your assemblies in Onshape. Switch over to this empty Assembly tab and insert everything from the Part Studio. All the parts are completely free to move and have all their degrees of freedom. First, fix one of the parts so that it removes all its degrees of freedom, so all other parts are mated with respect to it. To do this, right click on the part in the graphics area or features list and select Fix. Any part that is fixed has this icon next to it in the features list.

Onshape defines mates based on the intended behavior that you would like as a result, such as fastened, revolute, slider, planar, cylindrical, pin slot, ball, and parallel. To have this part slide along the base, select the Slider Mate. Onshape prompts you for a mate connector. These are at the heart of adding mates. Roll your pointer over any face, and small dots appear. These are locations on faces where you establish mate connectors. When rolling over one of these dots, a small triad appears. In addition to being locations on faces and edges, mate connectors act as a coordinate system with their own x-, y- and z-axes. The orientation of the axes is important, particularly for certain types of mates. To slide this part along the blue z-axis of the triad, orient the blue axis normal to the edge of the part and click to snap it into place.

For the second ,ate connector, roll over the faces of the other part and the same principle applies. Pay attention to the orientation of the triad. When clicked, the part snaps into place. Notice there are icons to flip the primary and secondary axes in case you need to make any adjustments and obtain the correct results. With this single mate added using mate connectors, you can remove several degrees of freedom in just a few steps.

The Slider Mate is now listed in the features list. Double-click to open it and make adjustments to the mate. For example, use the dropdown to change this mate to any other mate type, or to redefine any of the mate connectors.

To fasten the spindle inside the shaft, click the Fastened Mate. This mate type removes all degrees of freedom between any two mate connectors, so they are bonded together. For these mate connectors, select the point on the face inside the shaft and on the face of the spindle. Rotating one of the parts rotates them both.

Next, mate the screw with the sliding jaw. Use the Revolute or Cylindrical Mate. Revolute removes an additional degree of freedom than Cylindrical does. Click Cylindrical Mate. Roll over the cylindrical face of the jaw. There are three default mate connector locations along its axis. Select the point at the rear of the cylinder and repeat the process for the shaft. When the parts snap into position, you may notice that previously added mates are not solved. In these instances, click the Solve button. Finally, click the checkmark to close the Mate dialog.

At this point, the spindle is free to rotate about the mate connector and is also free to move along the axis. This is the way the Cylindrical Mate operates. Double-click the Cylindrical Mate to open its dialog and change it to Revolute. Now, moving the spindle rotates it without moving it away from the mate point on the jaw.

Keep in mind that you can use the mate connector tool to precisely define the location and orientation of mate points ahead of time, without having to create the ,ates. You can even add mate connectors to parts in your Part Studio so they are available when those parts are inserted into your assemblies.

  1. Click Mate Connector feature icon.

    Mate connector dialog

  2. Choose between creating a mate connector on a sketch or part (entity) or between sketches/parts:
    • On entity - Create a mate connector on a part or sketch:

      Example of the option to choose between creating a Mate connector on a part entity or between parts

    • Between entities - Create a mate connector halfway between two entities on the part or sketch:

      Example of creating a Mate connector halfway between two entities on the part

  3. Select a point on the part or sketch for the mate connector:
    • Roll over any face to activate the potential mate connectors and select a point.
    • Or click anywhere on a face to automatically place the mate connector at the centroid point.

      You are also able to select the Origin as an entity; select the Origin in the graphics area, or in the Instances list.

  4. Specify options, if desired (as shown in options examples below).
  5. Click Accept checkmark icon.

With the Mate connector dialog open, moving the cursor over a part "wakes up" default inference points and the inference point closest to the cursor highlights as a mate connector. As you continue to mouse over the sketch or part, different default inference points appear.

To lock mate inferences when you see the one you want to select, hold the Shift key when mousing.

Each face and edge of a part or sketch has default inference points:

  • At the centroid
  • At the midpoints
  • At the corners
  • At the virtual sharps of conical faces:

    Example of Mate Connectors on Virtual Sharps

    Inference points at the top, middle, bottom, and at the virtual sharp (where the sides of the conical face would meet if extended) of the conical face

  • At the centroids of any region contained in a planar face (for example, holes, and slots)

Before the default Mate connector is highlighted at the centroid (left), you might see the centroid point icon (right):

Example of how each face and edge of a part has default inference points Example shows centroid point icon

For cylindrical faces, inference points appear on the axis of the cylindrical and partial cylindrical face:

Example of how on cylindrical faces, inference points appear on the axis of the cylindrical and partial cylindrical face Example of how on cylindrical faces, inference points appear on the axis of the cylindrical and partial cylindrical face

Select a planar face that has a partial cylindrical edge, and the Mate connector inference points include the centroid of the axis:

Example of selecting a planar face that has a partial cylindrical edge and the Mate connector inference points including the centroid of the axis

Hover over the edge of the partial cylindrical face, and the default Mate connector appears at the centroid of the axis:

Example of hovering over the edge of the partial cylindrical face, and the default Mate connector appears at the centroid of the axis

If you select a curve endpoint or control point, the Mate connector is aligned with the global Z-axis (shown in blue):

If you select the curve itself, the Mate connector is aligned tangent to the curve at the closest implicit end, control, or midpoint

To zero in on a specific inferenced point or default mate connector without waking up others as you move the cursor, use the SHIFT key to prevent other mate connectors from appearing.

Check Realign to change the orientation of the mate connector along a primary and (optionally) a secondary axis.

These options are useful if you want to realign the default mate connector's orientation so that mated parts are aligned to each other in the required direction. Rather than modifying the mate, you can modify a mate connector to get the desired results.

  • Primary axis entity - Controls orientation of the Z axis. Select an entity in the graphics area to use as the primary axis.

  • Secondary axis entity - Controls the orientation of the XY axes. Select an entity in the graphics area to use as the secondary axis.

Mate connector dialog: Realign

Example of Mate connector's secondary axis realigned:

Realign Mate connector example

Move the mate connector a specified distance in a specified direction. The fields are presented in this order:

  • X translation
  • Y translation
  • Z translation

You can also use the Rotate field to specify a rotation of a specified number of degrees.

You can use expressions and trigonometric functions in numeric fields in assemblies.

Flip primary axis of Mate connectors

Flip the primary axis 180 degrees.

Flip Mate connector icon

Reorient secondary axis of Mate connectors

Move the primary axis one quadrant at a time through the X/Y coordinates.

Example of moving the primary axis one quadrant at a time through the X/Y coordinates

The inference points for potential mate connectors available when you select an edge or face are:

  • Planar face - Parallel to the face at every vertex, arc center, edge midpoint, and the face centroid
    Planar face inference icon

  • Cylindrical face - Perpendicular to the face axis at the middle and ends
    Cylindrical face inference icon

  • Linear edge or sketch line - Perpendicular to the line at the middle and ends
    Linear edge or sketch line inference icon

  • Circular edge or sketch circle - Perpendicular to the line at the middle and ends
    Circular edge or sketch circle inference icon

  • Curve endpoint and control point - Aligned with the global Z-axis
    Curve endpoint inference icon

  • Curve - Tangent to the curve at the closest end, control, or midpoint
    Curve inference icons

  • Vertex - Normal to the given face

    Mate connector on a vertex whose primary direction is normal to the given face

Once created, you are able to hide or show mate connectors in both Part Studios and assemblies:

  • Use the context menu in the Feature list (Hide, Hide other Mate connectors/Show, Show all Mate connectors)
    • Hide other Mate connectors hides all Mate connectors except the one you have selected.
  • Use the visibility eye icon icon in the Feature list to hide a specific mate connector.
  • Hiding/showing mate connectors in a Part Studio or assembly is exclusive to the Part Studio or assembly. Mate connectors hidden in a Part Studio are visible when inserted into the assembly. You have the ability to view mate connectors in a Part Studio and keep them hidden in the assembly, and vice versa.
  • If the behavior is not what you expected, try flipping the primary and/or secondary axis on the mate connector.
  • Use the SHIFT key to keep the mate connectors you want visible as you move the pointer to select one. This can be useful when the inferenced point for potential mate connector you want is on or near an edge.
  • All mate connectors are listed in the Feature list; you are able to hide/show them, edit and adjust, change, and use different orientations of the connectors.
  • You can also select and hide/show mate connectors when working in context.
  • A mate connector may be created in both the assembly and the Part Studio. Creating a mate connector in the Part Studio has three advantages:
    • You are able to select the origin from the Feature list in a Part Studio when defining a mate connector.
    • You are able to reference sketch entities in the Part Studio. This gives you the ability to define the mate connector in more positions than are possible in an assembly.
    • A mate connector defined in a Part Studio is available for reuse on every instance of that part in every assembly in which it is instanced.
  • When creating a mate connector in the Part Studio, there is an additional option in the Mate connector dialog called Owner Entity.

    Mate connector dialog in Assembly
    Mate Connector dialog in Assembly

    Mate connector dialog in Part Studio
    Mate Connector dialog in Part Studio

    In a Part Studio with multiple parts , it can be unclear which part owns the Mate connector. Use the Owner Entity field to specify which sketch, part, or curve owns the Mate connector, or leave the Owner Entity field blank to create an ownerless Mate connector.

  • If Mate connectors are Part patterned in a Part Studio, they will all be added to the Assembly when the Part Studio is inserted. If you don't see your Mate connectors when the Part Studio is inserted into the Assembly, make sure the Part is listed as the Mate connector owner entity.

    Part patterned Mate connectors in an Assembly.

Mate connectors are local coordinate system entities located on or between sketches, parts, curves, and surfaces. They are used within a mate to locate and orient sketch, part, curve, and surface instances with respect to each other. You can also use mate connectors to create planes.

  1. Tap the Mate connector tool icon ().

    Mate connector dialog

  2. Select origin type:
    • On entity - Create a Mate connector on a part or sketch.
    • Between entities - Create a Mate connector halfway between two entities on the sketch, part, curve, or surface.
  3. Select origin entity.
  4. Optionally, toggle to realign.

    If you do realign, select primary and secondary axis entities.

  5. Optionally, toggle to move.

    If you do move, specify X,Y, and Z values.

    Also select rotation axis and specify rotation angle.

  6. Select the owner entity.
  7. Tap the checkmark.

You can also create mate connectors in Part Studios while editing other features. See the appropriate feature tool topic for more information.

Each face and edge of sketches, parts, curves, and surfaces have default inference points:

  • At the centroid
  • At the midpoints
  • At the corners

Example showing Mate connector inference points on a face

Example showing Mate connector inference points on an edge

For cylindrical faces, inference points appear on the axis of the cylindrical and partial cylindrical face:

Example showing Mate connector inference points on a cylinder

Example showing mate connector inference points on a partial cylindrical face

Select or hover over a planar face that has a partial cylindrical edge and the Mate connector inference points include the centroid of the axis:

Example of inference points on a partial cylindrical edge

Select or hover over the edge of the partial cylindrical face and default Mate connector inference points appear:

Showng the default Mate connector inference points on a partial cylindrical edge while hovering

On entity

Select the origin entity then select the Mate connector inference point on which to place the Mate connector.

Mate connector example

Between entities

Select an origin entity and the Mate connector inference point in line with where you want to place the Mate connector. Select another entity and the Mate connector is placed in line with the Mate connector inference point, between the two entities you selected.

Example of Inference point between two endities

Toggle on Realign to change the orientation of the mate connector along a primary and (optionally) a secondary axis.

Select a primary and secondary axis along which to realign the mate connector.

Realign Mate connector example

Move the mate connector to a specified distance in a specified direction. The fields are presented in this order:

  • X translation
  • Y translation
  • Z translation

You are also able to use a rotation axis and specify a number of degrees to rotate the Mate connector.

Mate connector example showing how to rotate the connector

Example showing the moved Mate connector

Once created, you are able to hide or show mate connectors in both Part Studios and assemblies:

  • Use the context menu in the Feature list (Hide, Hide other Mate connectors/Show, Show all Mate connectors)
    • Hide other Mate connectors hides all mate connectors except the one you have selected.
  • Use the Hide/Show icon (the eye icon) in the Feature list to hide a specific mate connector.
  • Hiding/showing mate connectors in a Part Studio or assembly is exclusive to the Part Studio or assembly. Mate connectors hidden in a Part Studio are visible when inserted into the assembly. You are able to view mate connectors in a Part Studio and keep them hidden in the assembly, and vice versa.

Mate connectors are local coordinate system entities located on or between sketches, parts, curves, and surfaces. They are used within a mate to locate and orient sketch, part, curve, and surface instances with respect to each other. You can also use mate connectors to create planes.

  1. Tap Mate connector tool.

    Mate Connector tool icon

    Example of Mate connector tool dialog

  2. Select origin type:
    • On entity - Create a Mate connector on a sketch, part, curve, or surface
    • Between entities - Create a Mate connector halfway between two entities on the sketch, part, curve, or surface.
  3. Select origin entity.
  4. Optionally, toggle to realign.

    If you do realign, select primary and secondary axis entities.

  5. Optionally, toggle to move.

    If you do move, specify X,Y, and Z values.

    Also select rotation axis and specify rotation angle.

  6. Select the owner entity.
  7. Tap the checkmark.

Each face and edge of a sketch or part has default inference points:

  • At the centroid
  • At the midpoints
  • At the corners

Example of visualizing Mate connector points on a part face

Example of visualizing Mate connector points on an edge

For cylindrical faces, inference points appear on the axis of the cylindrical and partial cylindrical face:

Example of visualizing Mate connector points for cylindrical faces

Example of visualizing Mate connector points for a partial cylindrical face

Select or hover over a planar face that has a partial cylindrical edge and the Mate connector inference points include the centroid of the axis:

Example of visualizing Mate connector points for a partial cylindrical edge

Select or hover over the edge of the partial cylindrical face and default Mate connector inference points appear:

Example of visualizing Mate connector points for a partial cylindrical edge on hover

On entity

Select the origin entity then select the Mate connector inference point on which to place the Mate connector.

Example of using Mate connector tool on an entity

Between entities

Select an origin entity and the Mate connector inference point in line with where you want to place the Mate connector. Select another entity and the Mate connector is placed in line with the Mate connector inference point, between the two entities you selected.

Example of using Mate connector tool between entities

Toggle on Realign to change the orientation of the mate connector along a primary and (optionally) a secondary axis.

Select a primary and secondary axis along which to realign the mate connector.

Realign Mate connector example

Move the mate connector to a specified distance in a specified direction. The fields are presented in this order:

  • X translation
  • Y translation
  • Z translation

You are also able to use a rotation axis and specify a number of degrees to rotate the mate connector.

Mate connector example showing how to move the connector

Example showing the moved Mate connector

Once created, you can hide or show mate connectors in both Part Studios and assemblies:

  • Use the context menu in the Feature list (Hide, Hide other Mate connectors/Show, Show all Mate connectors)
    • Hide other Mate connectors hides all mate connectors except the one you have selected.
  • Use the Hide/Show icon (the eye icon) in the Feature list to hide a specific mate connector.
  • Hiding/showing mate connectors in a Part Studio or assembly is exclusive to the Part Studio or assembly. Mate connectors hidden in a Part Studio are visible when inserted into the assembly. You are able to view mate connectors in a Part Studio and keep them hidden in the ssembly, and vice versa.

For an additional Learning center resource, follow the technical briefing article here: All the ways to use Mate connectors (Onshape account required).