A Bill of Materials (BOM) is an essential part of mechanical design and assembly documentation in SOLIDWORKS. It lists the components required for an assembly, including part names, part numbers, descriptions, and quantities.
However, sometimes the SOLIDWORKS Bill of Materials does not update after you modify an assembly. Newly added components may be missing, deleted parts may remain in the table, or quantities may not match the actual assembly. These problems can lead to incorrect engineering drawings and confusion during manufacturing.
In this guide, you will learn how to troubleshoot common SOLIDWORKS BOM problems and keep your assembly documentation accurate.
1. Why Is Your SOLIDWORKS Bill of Materials Not Updating?
Several settings and assembly conditions can affect how a BOM displays component information. Common causes include:
- Automatic BOM updates are disabled.
- Components are excluded from the Bill of Materials.
- The wrong assembly configuration is selected.
- The BOM type does not display the expected components.
- Component properties or part numbers are incorrect.
- Components are suppressed or missing.
- BOM values have been manually edited and no longer match the model.
Before recreating the entire table, identify the cause of the problem. This helps you correct the BOM without unnecessary work.
2. Fix a SOLIDWORKS BOM That Is Not Updating Automatically
One of the first things to check is the automatic update setting.
Step-by-step solution:
- Open the affected assembly or drawing.
- Click Tools > Options.
- Select the Document Properties tab.
- Expand Tables and select Bill of Materials.
- Find the Automatic update of BOM option and enable it, if available.
- Click OK.
- Rebuild the assembly and drawing.
- Check whether the BOM reflects the latest changes.
If the table still does not update, save the model and drawing and confirm that the drawing references the correct assembly. If automatic updating is disabled, you may need to recreate the BOM to reflect the latest component changes.
3. Missing Parts in the SOLIDWORKS Bill of Materials
Have you added a component to an assembly, but it does not appear in the BOM? The component may be excluded from the BOM, suppressed in the active configuration, or omitted because of the selected BOM type.
Fix 1: Check whether the component is excluded
- Open the assembly.
- Find the missing component in the FeatureManager design tree.
- Right-click the component and select Component Properties.
- Look for the Exclude from bill of materials option.
- Clear the checkbox if the component should appear in the BOM.
- Click OK and check the table again.
Fix 2: Check the active configuration
A component may exist in one configuration but be suppressed in another. For example, a machine assembly may have a standard configuration and a simplified configuration. The simplified version may omit certain brackets, fasteners, or optional components.
- Open the assembly configuration used by the drawing.
- Check whether the missing component is suppressed.
- Unsuppress it if it belongs in that configuration.
- Rebuild the assembly.
- Verify that the drawing view references the intended configuration.
The BOM should represent the configuration you actually intend to document.
Fix 3: Check the BOM type
SOLIDWORKS provides different BOM types, and each displays components differently:
- Top-level only: Displays the top-level components and subassemblies.
- Parts only: Lists individual part components rather than displaying the full assembly hierarchy.
- Indented: Displays the assembly structure, including subassemblies and their components.
If you expect to see every individual component but have inserted a top-level BOM, the table may be working as intended. To correct this, edit the BOM properties and select the type that matches your documentation requirements.
4. SOLIDWORKS BOM Showing Incorrect Quantities
Incorrect quantities are a common problem in assemblies containing repeated components, subassemblies, or multiple configurations. For example, an assembly might contain four identical mounting bolts, but the BOM shows a quantity of one.
Step 1: Check the assembly instances
Expand the assembly tree and verify how many instances of the component are present. Make sure all required components have been inserted and that no unintended duplicate components exist.
Step 2: Verify the BOM configuration
BOM quantities depend on the configuration being documented. To check the settings:
- Open the BOM properties.
- Review the configuration selection.
- Confirm that the BOM refers to the intended configuration.
- Check the quantity display settings.
- Rebuild the assembly and drawing.
Step 3: Check whether identical components are grouped
SOLIDWORKS can combine matching component entries into a single BOM row, depending on the table settings and component information. For example, four identical bolts may appear in one row with a quantity of four rather than in four separate rows.
This is not necessarily an error. If similar-looking parts have different configurations or part numbers, they may appear as separate entries. Review the part numbers, configurations, and component properties to make sure the grouping matches your design requirements.
5. Incorrect Part Numbers or Descriptions in the BOM
A BOM may contain the correct components but still display incorrect information in the Part Number or Description columns. This can happen when component properties are missing, inconsistent, or manually edited.
How to fix it:
- Open the affected part or assembly.
- Locate its custom properties.
- Verify the part number, description, and other required information.
- Correct the properties and save the document.
- Return to the assembly drawing and rebuild it.
- Confirm that the BOM displays the correct information.
Use consistent property names across your parts library. This is especially useful when working with large assemblies containing many components.
Avoid unnecessary manual edits: Some BOM columns are linked to model properties, while others may allow manual editing. When a value should remain linked to a component, update the relevant model property rather than relying on a manual table edit. Otherwise, changes to the BOM may overwrite manually entered information.
6. Deleted or Suppressed Components Still Appearing in the BOM
Sometimes a BOM includes a component that you no longer expect to see. Before deleting and recreating the table, check whether the component still exists in the active configuration or whether the BOM is configured to retain rows for missing components.
- Open the assembly and inspect the FeatureManager design tree.
- Check whether the unwanted component still exists.
- Verify its suppression state in the active configuration.
- Review the BOM settings for missing-component rows.
- Rebuild the model and drawing.
- Verify that the BOM displays the expected result.
SOLIDWORKS includes a Keep the row for missing component setting. This controls whether rows are retained for components that are missing from a configuration. This can be useful when comparing assembly configurations, but it may cause confusion when you expect the BOM to show only the components included in the current design.
7. How to Keep Your SOLIDWORKS BOM Accurate
Fixing a BOM is important, but preventing errors from returning is even better. Follow these practices when working with mechanical assemblies:
- Use consistent component properties: Maintain standardized part numbers, descriptions, and naming conventions.
- Choose the right BOM type: Use top-level, parts-only, or indented BOMs based on your drawing requirements.
- Review configurations carefully: Check that the drawing view and BOM reference the correct configuration.
- Avoid unnecessary manual edits: Update linked model properties when component data needs to change.
- Rebuild and verify before release: After modifying an assembly, confirm the BOM, balloon references, and component quantities.
- Check the final drawing: Make sure listed quantities match the intended assembly and that missing components are accounted for.
A reliable BOM helps engineering teams reduce documentation errors and communicate design requirements more clearly.
Conclusion
A SOLIDWORKS Bill of Materials that does not update can be caused by automatic update settings, excluded components, incorrect configurations, BOM type selection, or inconsistent custom properties.
Start by identifying the affected component or quantity, check the relevant settings, and rebuild the assembly and drawing. In many cases, you can resolve the problem without recreating the entire drawing.
Developing a consistent assembly workflow will also help you create more accurate manufacturing drawings and manage complex mechanical designs with greater confidence.
SOLIDWORKS Mechanical Design & Assemblies Masterclass
Want to improve your SOLIDWORKS part modeling, assembly creation, and mechanical design skills?
Explore the masterclass by CADArtifex and develop practical CAD skills through structured learning and project-based exercises.
View Masterclass Course →