If you want to record a pizza formula substitution clearly, the safest documentation method is simple: keep the source formula unchanged, add a separate substitution note, and store your bake observations in a third record. That structure makes it easier to see what came from the original source and what you changed later.
This article is about record-keeping, not about proving that one ingredient or number will behave the same as another. For broader context on how changed inputs can affect outcomes, see The Four Numbers That Decide Your Pizza Crust.
Why rewriting the source formula causes confusion
When a reader copies a formula and silently replaces one ingredient, one percentage, or one unit expression, the record stops being a clean copy of the source. After that, two basic questions become harder to answer:
- What did the original author actually specify?
- What did the reader change before mixing or baking?
That matters because later troubleshooting depends on isolating changes. If the source formula and the reader's edit are merged into one unlabeled version, the record no longer shows whether a result came from the published formula or from the substitution.
Fact: a rewritten formula is no longer a verbatim source copy. Recommendation: preserve the source wording and numbers first, then add your own layer of notes.
This is also consistent with transparent documentation practice. A traceable note lets another reader see the source, the modification, and the later observation as separate steps instead of one blurred record. If you want a broader framework for documenting dough decisions and outcomes, the related reference on how we test: the bake-record method may help.
Keep three records separate: source, substitution, and observation
A practical way to record a pizza formula substitution is to separate your notes into three parts.
1. Source formula
This is the original formula as published.
Include, when available:
- source title
- author or publisher name
- URL or book/page reference
- date accessed or publication date if the source provides one
- ingredient names exactly as written
- units and percentages exactly as written
- process notes exactly as written when relevant to interpretation
2. Substitution note
This is your change log.
Include:
- what you changed from
- what you changed to
- whether the change was a unit conversion or a material change
- why you changed it
- what you expect the change might affect
- what remains unchanged
3. Observation note
This is your later record of what happened.
Include:
- mix or bake date
- anything you noticed during mixing, fermentation, shaping, or baking
- what you still cannot explain
- questions to revisit next time
Recommendation: do not merge these into one unlabeled recipe card. Keeping them separate does not guarantee better pizza, but it does produce a cleaner trail of evidence for later comparison.
A minimal substitution log template
Below is a reader-run worksheet template. It is an example for documentation only, not a tested formula.
Worksheet template
- Source title:
- Source author or publisher:
- Source URL or location:
- Source date or access date:
- Original item exactly as written:
- Original quantity or percentage exactly as written:
- Changed from:
- Changed to:
- Type of change: unit conversion / material substitution / omitted item / added item
- Reason for change:
- Expected effect, if any:
- Left unchanged:
- Unknowns not verified from source:
- Observation link or bake-log reference:
That final "unknowns" field is useful because many formula comparisons fail when readers assume details that were never supplied. If the source does not specify flour type, mixing method, dough temperature target, or fermentation conditions, write that uncertainty down rather than filling the gap from memory.
If you need a structured place to keep percentages and ingredient math, the internal reference pizza formula worksheet: baker's percentages fits naturally alongside this log.
How to write a substitution note another reader can trace
Traceable notes are usually plain, not clever. Use direct labels such as:
- changed from
- changed to
- left unchanged
- source says
- reader changed
Recommendation: record the original units exactly before converting anything. For example, if a source gives grams, copy grams first. If a source gives baker's percentages, copy those percentages first. Only after that should you add your own conversion note.
That distinction helps because not every edit is the same kind of edit.
Unit conversion versus formula change
A unit conversion keeps the same underlying quantity but expresses it differently.
A formula change alters the ingredient, percentage, or amount actually used.
Those should be labeled differently in your notes. Otherwise, a later reader may mistake a formatting decision for a dough decision.
For general source transparency standards, readers may also want the reference page on how Boccalone chooses and cites sources.
How this helps when a bake goes wrong
A traceable substitution note makes troubleshooting easier because it narrows the list of suspects. If the bake result differs from what you expected, you can review:
- what the source actually specified
- what you changed before making the dough
- what you observed afterward
That does not tell you the single cause by itself. It does make the record more useful when you compare likely factors such as hydration, dough temperature, fermentation time-and-temperature, and bake conditions, which are explained in The Four Numbers That Decide Your Pizza Crust.
Recommendation: link each substitution record to a separate bake log rather than embedding every observation into the formula itself. That way, one source formula can connect to multiple bake attempts without losing the original text.
A labelled example readers can copy
Example: documentation worksheet only
- Source title: Weeknight Pizza Dough
- Source author or publisher: Example source
- Source URL or location: example source URL
- Source date or access date: access date recorded by reader
- Original item exactly as written: "Flour: 100%"
- Original quantity or percentage exactly as written: "Water: 65%"
- Changed from: water 65%
- Changed to: water 67%
- Type of change: material change
- Reason for change: reader wanted to track a deliberate change separately from the source
- Expected effect, if any: unknown; reader records expectation without claiming equivalence
- Left unchanged: flour percentage, salt percentage, yeast entry, source wording for process
- Unknowns not verified from source: flour specification not fully described by source
- Observation link or bake-log reference: bake log entry 2026-11-11-A
Notice what this example does not do: it does not rewrite the source as though 67% had always been there. It preserves the fact that the source says one thing and the reader changed one thing.
A short checklist for future entries
Before you save a formula with a substitution, check these points:
- Did you preserve the original formula exactly as given?
- Did you label the change as a conversion or a material substitution?
- Did you record both the original value and the new value?
- Did you note what stayed unchanged?
- Did you write down any unknown source details instead of guessing?
- Did you store bake observations outside the source formula itself?
That small discipline keeps your records readable later. More importantly, it makes your notes easier for another reader—or your future self—to trace without confusing the source formula with your own edits.