Resolving Mate Conflicts and Rebuild Lag in SolidWorks Assemblies
Systematic approach to diagnosing and fixing conflicting mates, over-defined constraints, and rebuild performance issues caused by circular mate dependencies.

Resolving Mate Conflicts and Rebuild Lag in SolidWorks Assemblies
Mate conflicts in SolidWorks are the kind of problem that sneaks up on you. Everything is working fine, then you add one more mate and suddenly the assembly won't rebuild, components are jumping to random positions, and the feature tree is lit up with red and yellow warnings. I've spent way too much of my career untangling mate conflicts — both my own and other people's. Here's the systematic approach I use to diagnose and fix them without making things worse.
Understanding Mate Status Indicators
SolidWorks uses color-coded icons to indicate mate health:
- Green: The mate is satisfied and the component is fully constrained.
- Yellow: The mate is satisfied but over-defined — the component has more constraints than degrees of freedom. The assembly still rebuilds, but the redundancy may cause future conflicts.
- Red: The mate is unsatisfied — the constraint cannot be met with the current geometry. The assembly fails to rebuild correctly.
Step 1: Run Mate Diagnostics
SolidWorks provides a built-in diagnostic tool for identifying mate problems:
-
Go to Tools > Evaluate > Mate Diagnostics.
-
The Mate Diagnostics panel opens, displaying:
- Conflicting mates: Pairs of mates that contradict each other
- Redundant mates: Mates that over-constrain a component without adding new information
- Unsatisfied mates: Mates that cannot be solved with the current geometry
-
Click each entry to highlight the affected mates and components in the graphics area.
Step 2: Identify the Conflict Source
When the Mate Diagnostics tool identifies a conflict, it lists the mates involved but does not always explain why they conflict. You need to analyze the degrees of freedom manually.
Degrees of Freedom Analysis
Each component in an assembly has 6 degrees of freedom: 3 translational (X, Y, Z) and 3 rotational (Rx, Ry, Rz). Each mate consumes specific degrees of freedom:
| Mate Type | DOF Consumed | |---|---| | Coincident (face-face) | 1 translation + 2 rotation | | Concentric (cylindrical) | 2 translation + 2 rotation | | Distance | 1 translation | | Angle | 1 rotation | | Width | 2 translation + 2 rotation | | Symmetric | 1 translation + 1 rotation | | Lock | All 6 |
A component is fully constrained when all 6 degrees of freedom are consumed. Adding more mates beyond this point creates over-definition.
Example Conflict
A bolt inserted into a hole with a Concentric mate (consumes 4 DOF) and a Coincident mate between the bolt head and the plate surface (consumes 3 DOF) is already fully constrained with 1 DOF to spare (rotation around the bolt axis). Adding a third mate — such as an Angle mate to fix the bolt's rotation — would consume the remaining DOF, which is fine. But adding a second Coincident mate between the bolt head and a different surface would conflict with the first Coincident mate, because the two surfaces are not coplanar.
Step 3: Fix Over-Defined Mates
Suppress Redundant Mates
The safest approach is to suppress mates that are identified as redundant:
- Right-click the over-defined mate in the feature tree.
- Select "Suppress."
- Rebuild the assembly (
Ctrl + B). - Check if the conflict is resolved.
If suppressing one mate resolves the conflict, that mate was redundant. You can delete it permanently or keep it suppressed as a reference.
Use the MateXpert
For complex conflicts involving multiple mates, use the MateXpert:
-
Click the red mate error icon in the feature tree.
-
Select "MateXpert" from the popup menu.
-
The MateXpert dialog displays:
- The conflicting mate pairs
- Which mate should be suppressed or modified
- A suggested resolution
-
Follow the suggested resolution, then click "Rebuild" to verify.
Step 4: Fix Unsatisfied Mates
Unsatisfied mates (red) occur when the geometry referenced by the mate has changed. For example, if a Concentric mate references a cylindrical hole that was later changed to a square cutout, the mate can no longer be satisfied.
Re-reference the Mate
- Right-click the unsatisfied mate.
- Select "Edit Feature."
- In the Mate PropertyManager, the invalid reference will be highlighted in red.
- Click the red reference to remove it.
- Select the new correct face/edge in the graphics area.
- Click the checkmark to apply.
Delete and Recreate
If the mate type is no longer appropriate (e.g., the geometry changed from cylindrical to flat), delete the mate and create a new one with the correct type:
- Right-click the mate > Delete.
- Use the Mate tool to create a new mate with the appropriate type for the current geometry.
Step 5: Resolve Circular Dependencies
Circular dependencies occur when Component A is mated to Component B, and Component B is mated back to Component A through a different path. The solver cannot determine which component's position is the "source of truth."
Identify Circular Dependencies
- Go to Tools > Evaluate > Assembly Visualization.
- Add the "In-Context References" column.
- Sort by this column to see which components have references to each other.
Alternatively, use the Display Dependencies tool:
- Right-click a component > "Display External References."
- Review the list of references. If Component A references Component B, and Component B references Component A (directly or through intermediate components), you have a circular dependency.
Break the Cycle
To break a circular dependency:
- Identify the "weakest" mate in the cycle — the one that is least critical to the assembly's function.
- Replace it with a mate to a fixed component (a component anchored with a Fix mate or to the assembly origin).
- Rebuild and verify the cycle is broken.
Use Fixed Components
Anchor one or more key components with a Fix mate:
- Right-click the component > "Fix."
- The component is now locked in place and serves as a stable reference for all other mates.
This is particularly important for the base frame or main housing of an assembly. All other components should be mated relative to the fixed component, not relative to each other.
Step 6: Optimize Mate Order for Rebuild Performance
The order in which mates appear in the feature tree affects rebuild time. SolidWorks solves mates sequentially — if a mate early in the list depends on a component whose position is determined by a mate later in the list, the solver must iterate multiple times.
Reorder Mates
-
In the feature tree, expand the "Mates" folder.
-
Drag mates to reorder them so that:
- Mates to the fixed component are first
- Mates between components that depend on the fixed component are next
- Mates between secondary components are last
-
After reordering, rebuild (
Ctrl + Qfor a forced full rebuild).
Use Mate Folders
Group mates by sub-system:
- Right-click the Mates folder > "Add Folder."
- Name the folder after the sub-system (e.g., "Drive Train," "Enclosure").
- Drag related mates into the folder.
SolidWorks solves mates within a folder as a group, which can improve solver efficiency for assemblies with distinct sub-systems.
Step 7: Use the "Isolate" Tool for Troubleshooting
When a conflict involves many components, isolate the affected parts to simplify the view:
- Select the components involved in the conflict.
- Right-click > "Isolate."
- All other components are hidden.
- Fix the mate conflict in the isolated view.
- Click "Exit Isolate" on the toolbar to restore the full assembly.
Step 8: Prevent Future Conflicts
Use a Consistent Mating Strategy
Establish a team standard for mating:
- Always mate to the fixed base component first
- Use Concentric + Coincident for cylindrical joints (shafts, pins, bearings)
- Use Width mates for symmetric components (brackets, spacers)
- Avoid Distance mates for alignment — use Coincident with reference planes instead
Avoid Mating to Edges
Edge mates are fragile because edges are often consumed or recreated when features are modified. Mate to faces or axes instead, which are more stable across design changes.
Use Reference Geometry
Create reference planes and axes specifically for mating purposes. These are more stable than feature-generated faces because they do not change when the feature geometry is modified.
- Go to Insert > Reference Geometry > Plane.
- Create a plane at the mating location.
- Mate to this plane instead of a feature face.
If the feature geometry changes later, the reference plane remains in place and the mate continues to be satisfied.
Source Verification
More Solidworks Guides
troubleshooting
Fixing SolidWorks License Error 5: No Feature Available
12 min read
troubleshooting
Repairing Imported STEP and IGES Geometry in SolidWorks: Surface Knitting and Solid Recovery
13 min read
performance
Large Assembly Performance Tuning in SolidWorks: System Settings and Workflow Strategies
14 min read
manufacturing
Configuring K-Factor and Bend Tables for Accurate Sheet Metal Flat Patterns in SolidWorks
13 min read
Related Troubleshooting Guides
Similar troubleshooting content for other CAD tools
3ds Max
•troubleshooting
3ds Max FBX and OBJ Import: Missing Materials, Broken UVs, and Texture Path Recovery
11 min
3ds Max
•troubleshooting
3ds Max Plugin DLL Errors: Missing Files, Load Failures, and plugin.ini Repair
9 min
3ds Max
•troubleshooting
3ds Max Random Crashes: Memory, Driver, and Crash Log Analysis Guide
10 min
Altium Designer
•troubleshooting
Fixing Altium Designer DRC Errors: Common Clearance and Routing Violations
9 min