A density, in grams per millilitre, lets FourFoxes convert one ingredient between weight and volume. Add one when you buy an ingredient by volume but measure it by weight in your recipes, or the other way round. Without a density, a Bill of Materials (BOM) line has to use the same kind of unit the ingredient is bought in.
When you need a density
Every ingredient is bought and counted in its Unit of measure. A BOM line can use any unit in the same family: weight units for an ingredient bought by weight, volume units for one bought by volume. Say you buy honey by the gal but your recipe calls for grams. Without a density, the BOM line shows an error that names the ingredient and links to Add a density to it. With a density, you can enter the line in grams.
The density only converts. Stock, purchases, and lots stay in the ingredient's own unit. Lot draws, batch cost, and the ingredient order on a recipe nutrition label all use the converted amount.
Add a density to one ingredient
- Open Ingredients (in the account menu, under Sourcing) and click the pencil (Edit) button on the ingredient. For a new ingredient, click Add Ingredient.
- Enter the Density (g/mL). It must be between 0.2 and 3.0, with up to four decimal places. Water is 1.0. A supplier spec sheet is a good source.
- If the ingredient is matched to a USDA food, a Suggested density shows under the field, with the USDA FoodData Central record and the portion it comes from. Click Use suggested to fill the field.
- Click Save Changes (or Create Ingredient for a new one). Nothing is saved until you do.
The suggestion appears only on the edit page, only for an ingredient matched to a USDA food, and only while it has no density saved. To match one, open the ingredient and, under Nutrition Data (FDC), click Search Foods, then Select Food on the right result. If USDA data cannot be reached, no suggestion shows and you type the value yourself. Check a suggestion against your own product: a USDA portion is a general figure, not your supplier's spec.
Fill in many densities at once
Admins and Owners can click Add missing densities on the Ingredients list. The Set ingredient densities page lists every active ingredient that has no density.
- Rows for ingredients matched to a USDA food load a suggested value with its source. Change any value you want to. A row showing No suggestion or Suggestion unavailable needs a value typed in.
- Tick Save on each row you want to keep.
- Click Save selected. Unticked rows are not saved, even if they have a value.
If any ticked value is outside 0.2 to 3.0 g/mL or has more than four decimal places, nothing is saved and the error shows on that row. An ingredient with no USDA match has no Save box; it shows Link an FDC food on the detail page instead. Match it to a USDA food first, or add its density on its own edit page.
Change or clear a density
When you change a density, FourFoxes recalculates every BOM line for that ingredient that was entered across weight and volume, so the amount you typed on the line stays the same. Lines in the ingredient's own unit family are not touched. A recipe label built from an affected BOM shows BOM changed until you refresh it.
You cannot clear a density while BOM lines depend on it. The edit page shows Density is needed by mass/volume lines on followed by the BOMs. Change those lines to the ingredient's own unit family first, then clear the density.
Once an ingredient is on a BOM or has purchases recorded, its Unit of measure cannot be changed. Respellings such as lbs to lb are still accepted. To weigh a liquid in recipes, add a density instead. To really switch units, create a new ingredient and swap it into your BOMs.
Related