Home

Open Brew - Format Description

Here we go with some documentation. Each field will appear by it's name, type and description.

Some elements need a concrete specification of their unit types. The supported unit types for the respective element are defined below.

Element	Type	Possible Values
ratioUnit	string	gramPerLiter, percent, degreePlato
tempUnit	string	celsius, fahrenheit, kelvin
timeUnit	string	week, hour, minute, second, millisecond
tasteUnit	string	ibu
chemicalUnit	string	dh, ppm

Element	Type	Description
openBrewVersion	string	Defines the version of the Open Brew Format (major.minor.patch)
encoding	string	Defines the encoding of the current json document, standard ist "UTF-8"
recipeName	string	The Name of the beer brewing recipe
recipeVersion	number	Defines the version of the recipe. Every change increases the value by 1, beginning by 1
brewStyle	string	Brew style, i. e. "Amber Lager". Freetext, too much variations here
descriptions	array Multi language texts	Describe your recipe in a few words. Muliple languages supported
totalAmount	object Amount	Describes how much beer is being expected at the end of the day
originalWort	object Amount	The amount of original wort in your maish. Nearly always describes in percent
bitterness	object Amount	Describes the bitterness of your beer. IBU is the unit
carbonDioxide	object Amount	The little thing, that makes you burp comes up with that likely name. It's preferred to define it in gram per liter
author	object Author	Provides information about the author of the current recipe
ingredients	object Ingredients	Provides every commodity you need to start brewing
brewing	array Brewing	Describes the hard way to glory. The steps to your own beer. And that manual and also fully automated. Automated is not so hard ;)

Element	Type	Description
private	boolean	Indicates if the author is a private or commercial brewer
brewery	string	Name of the brewery
brewMaster	string	Full name of the brew master, i. e. "Hannes Pfaffenhuber"
url	string	A valid url to the authors homepage, i. e. "http://holdmybeer.de"
phone	string	The phone number with country code, i. e. "+49 911 123456789"
address	object Address	The full address of the brewery or the private brewmaster
geo	object Geo	Provides geo coordinates of the address for displaying at maps, etc.

Element	Type	Description
street	string	Full street name with house number and additions (i. e. "Street 14 A")
zip	string	Zip of the address, string for international use
city	string	The city of the address. For multilingual citynames, use english version
federated State	string	The federated state (not available in all countries) i. e. "Bavaria"
country	string	The name of the brewers country

Element	Type	Description
latitude	number	Latitude of the address (value between -90 and 90)
longitude	number	Longitude of the address (value between -180 and 180)

Element	Type	Description
water	object Water	An object that provides some data about the brewing water
yeast	object Yeast	The details about the yeast to use
grains	array Grain	This array contains all used grains and their details
hops	array Hop	This array contains all hops and their details
customIngredients	array Custom Ingredients	This array contains all custom, free definable ingredients (i. e. honey)

Element	Type	Description
alkalinity	object Amount	Defines the required, ideal alkalinity of brewing water
mashingWater	object Amount	The part of the brewing water that is used during mashing
spargingWater	object Amount	The part of the brewing water that is used for sparging. In German brewing that is oftentimes less than the amount of water used for mashing