How to Troubleshoot SOLIDWORKS Assembly Mates

Direct answer: troubleshoot SOLIDWORKS assembly mates by identifying the affected configuration and components, reading the actual mate error, isolating the conflicting or missing relationship, and repairing one cause at a time. Rebuild and check the intended motion afterward. A visually correct position alone does not show that the assembly is constrained as intended.

This walkthrough is for a mechanical engineer practicing on a copy of a small assembly. Preserve the original file and its referenced components before experimenting.

Find your symptom: replace a component and reattach mates, selected entity is not valid, movement, conflict or missing reference; then follow the shaft-and-bracket exercise.

“Selected entity is not valid for current mate type”: what to check

Start with the geometry selected for the mate. An unsuitable selection and a conflict between existing constraints need different repairs. In a copy of the assembly, note the mate type and identify each selected face, edge, plane or axis.

1. Clear the current selections and select the intended entities again. For a shaft and bore, inspect their cylindrical faces. Selecting a flat end face instead asks the solver to use a different kind of geometry.
2. Check the permitted combination. The official mate/entity table permits concentric mates between two cylinders; a plane and cylinder instead support distance or tangent mates. Choose geometry and relationships that express the intended design.
3. If the part was imported, inspect the surface type. A round-looking surface can be a B-spline rather than an analytic cylinder. The Import Diagnostics guide explains this limitation and possible conversion to analytic surfaces. Follow the STEP import checks; a visual resemblance is not enough.
4. Then inspect constraint conflicts. If the selections are valid but the mate cannot solve, use the diagnostic sequence below. Record the actual message, selected references and active configuration.

For example, selecting two flat shaft-end faces will not create the intended concentric relationship. Selecting the shaft and bore cylinders addresses that selection mismatch; it does not establish axial location or prove that the complete assembly is correct. If the required surface cannot be identified, stop and resolve the source geometry before adding substitute constraints.

Replace a component without losing mates: what can be preserved?

Start by distinguishing a new configuration of the same component from a replacement file. Record the intended configuration and the instances affected. A similar outline does not establish that the new component has the same mating references.

1. Work on a copy with its references. Record the existing locating faces, axes or planes and the movement the component must retain.
2. Choose the replacement and configuration deliberately. In Replace Components, inspect which instances will change. Use Re-attach mates to review the existing relationships during replacement.
3. Resolve missing entities individually. The Mated Entities PropertyManager supports reattaching dangling references. Select a replacement reference that preserves the design requirement, then inspect the resulting alignment.
4. Check the result after rebuilding. Inspect mate errors, the active configuration, intended movement and the changed component’s fit. Save and reopen the practice copy before accepting it.

In the shaft-and-bracket exercise below, replacing the shaft creates two separate questions: does the new cylinder locate on the same axis, and does the intended shoulder still provide the axial location? Reattaching the first reference does not answer the second. If the replacement removes the locating shoulder, resolve the design change before choosing an arbitrary face.

The Missing Entities toolbar helps compare the original missing reference with the replacement. Keep a short record of the old reference, replacement reference and observed result. This is a documentation-based practice workflow, not a promise that every supplier part can be swapped automatically.

After changing a component’s configuration or identity, also check the resulting BOM rows and quantities.

Is it an error, unwanted movement or a lost reference?

Step 1: record the state before changing anything

Write down the assembly and configuration, component references, suppression state and the last change before the problem appeared. Identify whether the issue is unwanted motion, an unresolved error, a missing reference or a relationship that prevents intended motion. These are different problems.

A component can be fixed, constrained by mates, or positioned through a larger hierarchy. Inspect that context before adding another mate. More constraints do not automatically produce a better assembly.

Step 2: inspect the actual failing relationship

For unresolved mate errors, the official MateXpert workflow opens diagnostics through Tools → Evaluate → MateXpert or the relevant context menu. Diagnose the problem, inspect the implicated subset, and examine the unsatisfied mate’s selected geometry.

MateXpert analyzes one Mates folder at a time. If the problem is inside a subassembly, inspect that subassembly’s folder separately. An unavailable MateXpert command is not proof that the design meets its intended constraints.

Step 3: diagnose a shaft that should rotate but not slide

Use a synthetic two-component assembly: a fixed bracket with a cylindrical bore and a floating shaft. Assume the selected faces are compatible, there are no other mates, and concentric rotation is not locked. The intended result is rotation about the shaft axis with no axial sliding.

1. Concentric only: align the shaft and bore axes. Expect axial sliding and rotation to remain.
2. Add axial location: make the intended locating faces coincident. Expect axial sliding to stop while rotation remains.
3. Introduce a conflict in the practice copy: attempt a 5 mm distance between those same locating faces. It conflicts with the zero separation already required. The solver may reject the new relationship or show a mate error.

Record what your installed release displays; the observations above are expected outcomes for the stated example, not a published execution log. The official degrees-of-freedom explanation describes the concentric-plus-axial-location relationship.

Now diagnose the conflict:

1. Check that the selected cylindrical and locating surfaces are the intended ones.
2. Inspect whether an additional distance relationship contradicts the axial location already specified.
3. In the disposable copy, suppress only the suspected conflicting relationship and rebuild.
4. Observe whether the error disappears and whether the intended rotational freedom remains.
5. Repair or remove the redundant relationship only after understanding its design purpose.

This example teaches a diagnostic sequence; it is not a universal mate prescription for every shaft or bearing arrangement. A different mechanical requirement may need different relationships.

Check the repaired result

For this practice requirement, keep one consistent axial location. With the contradictory distance removed or corrected, verify that the shaft cannot slide and can still rotate. If it cannot rotate, inspect Lock Rotation, fixed state and other angular constraints. The correct result follows the intended motion, not a goal of removing every possible degree of freedom.

Step 4: repair the relevant cause

• Missing reference: inspect whether an edited or replaced component removed the selected geometry. Re-select the intended reference or use the appropriate replacement workflow.
• Alignment problem: check which direction the relationship requires before toggling alignment.
• Conflicting constraints: identify the incompatible requirements rather than suppressing the entire mate folder.
• Unexpected movement: compare remaining movement with the design’s intended degrees of freedom. Some movement can be intentional.
• Wrong configuration: verify component configurations and configuration-specific suppression before changing geometry.

Step 5: make the repair repeatable

Rebuild, inspect errors, exercise the intended movement, save the test result and reopen it. Compare the realized relationships and component identities with your requirement. Keep a before/after note naming the mate, selected references, change and observed result.

If the same parts are inserted repeatedly, SOLIDWORKS mate references can support repeatable insertion. They still require compatible names, entity counts and corresponding mate types; a reusable reference does not replace an engineering check.

Why this matters for automation

An automated system needs the same distinction between requested relationships and relationships actually created in CAD. A successful API call, a saved file and a clean geometric picture are different observations. Read how AI-created mates are verified and the native-CAD proof chain.

Continue with the first read-only API macro and BOM part-number/configuration tutorial.

Check the component geometry first

If the component itself changes unexpectedly, try the sketch-constraint exercise. If the geometry came from a supplier STEP file, use the import-diagnostics tutorial before treating an unusable face or incorrect unit scale as a mate problem.

One side mates, but the second side will not

This is a useful diagnostic pattern from a September 2026 community question. A successful first concentric relationship does not prove that a second pair of axes can align at the same time. Before forcing another mate, check both geometry and existing constraints.

1. In a copy, record the component configurations and check whether the moving component is fixed or controlled inside a rigid subassembly.
2. Measure the distance between the relevant axes on each component in the active configurations. If the distances differ, additional mates cannot make rigid geometry fit. Investigate the intended dimensions or mechanism with the designer.
3. Inspect which relationships already control centering, orientation and motion. A second relationship may be redundant or incompatible; that depends on the complete constraint set.
4. Use the actual mate diagnostic and isolate a suspected relationship in the copy. Observe the resulting degrees of freedom rather than deleting every mate.
5. Restore a consistent relationship set, rebuild, exercise the intended motion, save and reopen. Record what changed and why.

Stop condition: if the source dimensions or design intent are unclear, preserve the failing example and ask its owner. Moving geometry until the error disappears is not evidence of a correct repair. The community thread motivates this workflow; its replies are not a verified diagnosis of your assembly.

Keep a small repair record

Use columns for assembly/configuration, affected component, symptom, selected references, intended motion, one change tried, rebuild result and reopen result. Keep a before/after drawing register with Drawing Register Compare when the repair changes released sheets. That tool checks register labels; it does not inspect mates.

MST Mechanical Assembly AI addresses repeated assembly work in validated equipment scenarios with controlled parts and reviewable output. It is not advertised as an automatic repair service for every failing SOLIDWORKS assembly.

Frequently asked questions

Why does SOLIDWORKS say “selected entity is not valid for current mate type”?

The selected faces, edges, planes or axes do not form a combination that mate type supports. For example, a concentric mate expects cylindrical or circular geometry. Clear the selections, pick the intended entities again, and check whether an imported round face is actually a B-spline surface rather than an analytic cylinder.

How do I find which mate is causing a conflict in SOLIDWORKS?

Expand the Mates folder and look for error or warning icons, then use MateXpert or suppress recently added mates one at a time and rebuild. Repair one cause, rebuild, and only then move to the next error so you do not hide the original problem.

How do I replace a component without losing mates?

Use Replace Components with the option to re-attach mates enabled, then review every mate that reports a missing reference. Map each dangling mate to the equivalent face or plane on the new part, or use the Mated Entities dialog to reselect it.

Why does my part still move after I added mates?

It still has unconstrained degrees of freedom. Drag the component to see which directions remain free, then add only the relationship that matches design intent, such as a distance or angle limit, instead of fixing the part.

Is it OK to fix components instead of mating them?

Fixing the first base component is common practice. Fixing other components hides missing relationships and can make later changes harder, so prefer mates that express how parts actually locate against each other.

Scope: replacement workflow reviewed against official SOLIDWORKS 2026 documentation on 13 October 2026; this exercise was not executed in SOLIDWORKS for this publication. Absence of mate errors does not by itself prove fit, strength, collision clearance, manufacturability or production readiness.

See how the components become an equipment assembly

• Watch native components being assembled in SOLIDWORKS
• Explore equipment assembly using approved parts

FOR EQUIPMENT MANUFACTURERS AND DESIGN TEAMS

Talk to the engineering team.

Tell us what your team designs and which repetitive task you want to improve. A short, non-confidential description is enough to discuss a relevant demo. Arrange a private channel with MST before sharing company drawings or models.

Discuss your equipment design ↗sales@mst-us.ai ↗See the equipment assembly example ↗

Operated by MOORE SOLUTION TECHNOLOGY PTE. LTD. · Singapore UEN 202315239E