Libraries

24.1The library page

Open Libraries to see and edit your ingredients: Fermentables, Hops, Yeast and Misc. Most of it explains itself: open an entry, fill in the details, save.

• Import ingredients (a whole library or any BeerXML file) in Settings → Packs (see Import your whole library).
• Export from here: Export BeerXML saves the list you're looking at (Fermentables, Hops, Yeast or Misc) as a BeerXML file: names and the basic brewing figures only. No prices, suppliers, lots, yields, oils or tax settings.
• Add entry adds one ingredient. Fill in everything.
• Lot numbers: don't fill them in here. They're entered when a delivery arrives (see Your orders, and when they arrive).

24.2Fermentables

Fermentables are anything that goes in the mash, even if it doesn't all ferment.

Watch the yield on unmalted grains. Hakkotome always counts an ingredient's full yield. For rice, corn or unmalted wheat, that's only true if you do a cereal mash to open it up, and remembering the cereal mash is up to you.

If you use an unmalted grain without a cereal mash, make a copy of it, call it something like Unmalted wheat – no cereal mash, and set its yield to 0 (or what it really gives you).

Example: you brew a wit with 20% unmalted wheat straight into the mash. Use your "no cereal mash" copy, so the recipe doesn't count sugar that won't come out.

Origin country: where the malt comes from. It decides which column the malt goes in on the malt quota form (see Monthly Report (需給表)), Japanese or imported, and the ingredient origin on the label check sheet.

24.3Hops

• Name: type the hop's name, for example Amarillo. Leave Variety blank: Hakkotome fills it in from the name. (If your names carry a year or lot code, like Amarillo 2025, it strips that off, so every lot still groups under Amarillo.)
• Hidden: tick it to hide an old crop year from the list. You can keep adding each new crop with its new oil numbers without the list growing forever. Show hidden brings them back.
• Group by variety puts every lot of a hop under one heading.

24.4Yeast

Fill in the details. Nothing special to watch for.

24.5Misc

When you add a misc ingredient, two boxes decide how it's treated.

Type is the important one. It decides whether the ingredient appears on your tax pages, and whether it counts toward the 5% limit.

• Flavor, Spice and Herb are ingredients. They go on your tax pages, and they count toward the 5% limit — fruit, coriander, spices, herbs, and a Gose's salt.
• Water treatment, Acid, Fining, Nutrient and Enzyme aren't ingredients. They don't go on your tax pages and they don't count toward the 5% — gypsum, calcium chloride, lactic acid, Whirlfloc, yeast nutrient.

Press the ? beside Type to see the full legal list of what counts, with links to the National Tax Agency's guidance and to the regulation itself.

Salt appears on both sides, so read this one twice. Salt added for flavor — a Gose — is an ingredient and counts toward the 5%, so set its Type to Flavor. Gypsum and calcium chloride treat your water and aren't ingredients at all, so they're Water treatment. If you use both, keep them as two separate library entries with clear names.

Lactose goes in Fermentables, not here. It's a sugar, and sugars have their own rule — they don't count toward the 5%.

Happoshu trigger is a different question. Tick it only for something that makes a beer happoshu at any amount at all, no matter how little you use. The 5% limit doesn't apply to those — they're happoshu from the first gram.