Guide
BOM revision control: rev letters, change logs and matching Gerbers
BOM revision control means every released BOM carries a revision letter, a date and a change log, and is tied to the exact board files it was built with. If the BOM, the fabrication files and the placement file do not share a release, a board can be built from mismatched parts. Put the revision in the file name and inside the file.
Steps
Releasing a BOM revision
Choose one scheme
Letters for released revisions (A, B, C) and something distinct, such as X1, for prototypes. Write the rule down.
Release the set together
BOM, fabrication files, placement file and assembly drawing leave together under one revision.
Put the revision in two places
In the file name, such as SN-210_BOM_revC.csv, and inside the file, in a notes cell or the sheet title.
Log every change
Date, lines and designators changed, reason, who approved, and whether the board changed.
Diff before you send
Compare against the previous release. The differences should match the log, no more and no fewer.
Check the match
Compare the populated designators in the BOM with those in the placement file.
Scope
Which revision is which?
A bare board has a revision, usually printed in copper or silkscreen. A BOM has a revision. An assembly may have a third. They move at different speeds: changing a resistor value changes the BOM but not the board, while re-routing changes the board and often the BOM. Conventions differ between companies. What matters is that the record says which BOM revision belongs with which board revision, for example BOM D with board B.
A workable rule: bump the BOM letter for any change to an MPN, a quantity, a designator list or a DNP state, anything that could alter what is bought or placed. Description typos can follow a looser rule if you write it down.
Matching
Matching the BOM to the board files
A typical Gerber set describes the bare board, not the parts, so the match is made by checking. Confirm that the revision text in the board data equals the BOM's board revision. Then compare designators: every populated BOM designator should appear in the placement file, and the placement file should hold nothing that the BOM does not list as populated or DNP. Expect a short list of explainable exceptions, such as fiducials, mounting holes and logos. An unexplained designator on either side means the files come from different designs.
Example
One release in practice
Board revision B is already released. A review changes R14 from 10K to 4.7K and sets C9 to DNP, so the BOM moves from revision B to revision C while the board stays at B. The log row records both changes, the reason and the approver. The file is saved as SN-210_BOM_revC.csv, with revision C written inside it. The diff against the previous BOM should show those two lines and nothing else. A third difference means the log is incomplete, or someone edited the file by hand. Once C is released it is not edited: the next change is revision D.
Reference
What a revision record holds
| Field | Example | Why it is there |
|---|---|---|
| BOM revision | C | Names the document |
| Board revision | B | Ties the BOM to the fabrication files |
| Date | 2026-10-28 | Puts the releases in order |
| Change summary | R14 10K to 4.7K; C9 now DNP | Says what a reader should expect to see |
| Reason | ECO 0142 (an example number) | Traces why it changed |
| Approved by | Initials and date | Shows who released it |
| Files released | BOM, Gerber set, placement file | Names what travels together |
| Supersedes | Revision B | Lets a reader find the previous release |
Pitfalls
What goes wrong
- Names like final_v2_NEW.xlsx. They say nothing about order or approval.
- Revision in the name only. The file name says C and the contents are still B.
- Silent edits after a quote. The BOM changes with no new letter, so the quote and the build disagree. See BOM for assembly quotes.
- Renumbered designators. Re-annotation changes designators with no physical change, so an older BOM no longer fits the new board.
- One half re-exported. New Gerbers with the old BOM, or the reverse.
- No log. A spreadsheet edited by several people, with nothing recording who changed what.
Some industries and customers set their own record-keeping rules for BOM changes. This guide describes common practice, not compliance advice.
The tool
How BOMParser helps
BOMParser does not track revisions and does not compare two BOMs. What it gives you is a stable shape: every PDF BOM becomes the same ten CSV columns, so two revisions can be compared in a spreadsheet or a diff tool. The validation report records the file name, page count, totals and time of each conversion, and the checks show whether a revision's own arithmetic holds. Convert a file on the BOM to CSV page; pricing lists the plans. Free: one BOM every 24 hours, ten sheets or fewer, no registration. A free run stops at sheet 10 of a longer BOM. Redeem a code and the ceiling rises to 150 sheets.
FAQ
BOM revision questions
What is a BOM revision?
A lettered or numbered release of the BOM. It identifies one frozen list of parts, so a quote, an order and a build can all point to the same document.
Should the BOM revision match the PCB revision?
Not necessarily. They can move separately, but the record must say which BOM revision belongs with which board revision. Many teams use one assembly revision to avoid the question.
When should the revision letter change?
When anything that could change what is bought or placed changes: an MPN, a quantity, a designator list, a DNP flag or the board. Write your rule down and apply it every time.
How do I match a BOM to the Gerber files?
Check that the revision text agrees, then compare designators between the BOM and the placement file. Unexplained differences mean the files come from different designs.
What belongs in a BOM change log?
Date, revision, the lines and designators changed, the reason, the approver and whether the board changed. One row per release is enough for a small team.
How can I compare two BOM revisions?
Sort both by a stable key such as internal part number, then compare line by line in a spreadsheet or diff tool. Check the differences against the log.
Keep reading
Related guides
BOM for assembly quotes
What a quoting team needs to price a build.
BOM consolidation and duplicate lines
Merging same-MPN lines without losing designators.
BOM formats for PCB assembly
The columns assemblers expect, and consolidated versus per-designator rows.