# Recipe Editor

The **Recipe Editor** is the heart of the RAPT Recipes tool.

In the Recipe Editor, you can edit imported recipes or create your own recipes from scratch.

With a full featured database and powerful calculators built in, you can design delicious beers in a few minutes, or tweak existing recipes to suit your own tastes or brewing system!

The Recipe Editor is easy to use - it is laid out in a logical, step by step manner. As you work through the built in calculators will update to reflect brew details such as predicted ABV, EBC, IBU etc. You can also take adbvantage of the powerful and accurate Water Calculator to really fine tune your brew.

As the Recipe Editor is tightly integrated into the RAPT ecosystem, you can also easily add existing [**Brewing Profiles**](#brewzilla-profile) and [**Fermentation Profiles**](#fermentation-profile), or input the profiles directly and convert to a RAPT Profile with one click!

### Details

<figure><img src="/files/B34LNImYhpUzJIuyiQMD" alt=""><figcaption></figcaption></figure>

* First, name your beer - this can be anything you like.
* Enter the desired **Batch Size** - this is the volume of wort rather than the finished, packaged batch size. To scale the recipe to a different batch size, click the <img src="/files/6SoaK2nkrAMvwjUHBu9Q" alt="" data-size="line"> **Scale** button and enter the new batch size. If you wish to change batch size but to not scale the ingredients, deselect **Auto Scale Ingredients** before saving.
* Select **Boil Duration** - This will default to the boil time of the [**Default Brewing Equipment Profile**](/equipment/equipment-profiles.md). This can be changed manually using this option. **NOTE**: If a new equipment profile is selected in the recipe Editor, the Boil Duration will **not** change even if the new Profile has a different Boil Duration. This is to preserve the recipe volumes and specs. Thus, use this option to change Boil Duration.

<figure><img src="/files/EQxxGsHYh3x9RlAPUt4r" alt=""><figcaption></figcaption></figure>

* Toggle whether the recipe is **Public** or **Private**. If set to Private only you can see the recipe. If set to Public then your recipe will be searchable by any RAPT Recipe user

### Equipment Profile

<figure><img src="/files/L7E3825ddjmPQdoxBJJU" alt=""><figcaption></figcaption></figure>

Select the Brewing **Equipment Profile** here. All available Brewing Equipment Profiles can be selected. If you do not have any Equipment Profiles available they can be created or imported from [**Equipment Profiles**](/equipment/equipment-profiles.md). Equipment Profiles can also be customised once created. The equipment profile will set specs such as batch size, brewhouse efficiency, boil off, brew day losses etc

If the profile is changed, RAPT will prompt you to **scale** the recipe. This makes it easy to (for example) change a brew from a double to a single batch - simply switch to the appropriate **Brewing Equipment Profile** and RAPT will scale the recipe for you!

### BrewZilla Profile

<figure><img src="/files/2xJ86h9MJNH5mStEvQEf" alt=""><figcaption></figcaption></figure>

The default option is Manual Steps. You can then enter the desired Brewing Profile in the Recipe Editor in the [**Mash Steps**](#mash-steps) section. If you are using an existing **BrewZilla Profile** this can be selected from the dropdown instead. **NOTE**: If you enter the **Mash Steps** this can be converted into a BrewZIlla Profile and saved to your Profile Library with one click!

### Fermentation Profile

<figure><img src="/files/Ol3tRf17GcBdFj5hvqXW" alt=""><figcaption></figcaption></figure>

The default option is Manual Steps. You can then enter the desired Fermentation Steps in the Recipe Editor in the [**Fermentation** ](#fermentation)section. If you are using an existing **Fermentation Profile** this can be selected from the dropdown instead. **NOTE**: If you enter the **Fermentation** steps this can be converted into a Fermentation Profile and saved to your Profile Library with one click!

### Brew Specifications

The expected water volumes, batch and packaging volumes are listed here. These are linked to the Brewing Profile and Fermentables. Changing the Brewing Profile, grain bill and other recipes choices (such as yeast) will be reflected here.

**Pre-Boil Volume** - Volume of wort before boiling\
**Post-Boil Volume** - Volume of wort after boiling\
**Packaging Volume** - Volume of finished, packaged beer\
**Brewhouse Efficiency** - Overall Brewhouse efficiency\
**Mash Efficiency** - Mash Conversion efficiency

**Pre-Boil Gravity** - Expected Graivty *before* boil\
**Original Gravity** - Expected Graivty *after* boil\
**Final Gravity** - Gravity of finished beer\
**Diastatic Power** - Conversion power of mash

**Mash Water** - Volume of water before grain is added\
**Mash Volume (incl. grain)** - Total volume in brewery (water + grain)\
**Sparge Water** - amount of sparge water needed to hit pre-boil volume\
**Total Water** - total water volume required (mash + sparge)

### Style

Select a style appropriate to the beer you are making. The database is populated with all current BJCP styles, as well as style guidelines etc. Click the Search icon and start typing the beer style name to bring up a list of styles based on the name, or simply scroll through the list. Clicking on a beer style name will open up the description and guildelines for that style.

To select a style and apply it to the recipe, click the checkmark next to the style name

<figure><img src="/files/u1vM6IeQPkDHSDD8CfgY" alt=""><figcaption></figcaption></figure>

Once a beer style is applied to the recipe, the style guidelines section will be populated with the range appropriate to that style. This allows you to tweak ABV, OG, FG, EBC and IBUs if desired to suit the style.

<figure><img src="/files/hA5yJs0YFvz4NqLLcOxL" alt=""><figcaption></figcaption></figure>

### Fermentables

This is where the grain bill for the recipe is built. Click the <img src="/files/zV2saE9CKtQjjf4L6IkD" alt="" data-size="line"> **Add Button** and start typing the malt name in the search bar to find the desired malt

<figure><img src="/files/T8zC0C8rjDFUCH4rCWY0" alt=""><figcaption></figcaption></figure>

Once the desired malt is displayed, select it and enter the quantity, then select <img src="/files/KL6JJ8Tv7yIZvHgQvzuF" alt="" data-size="line"> to save the malt in the grain bill. As malts are entered and saved, the brew specifications will be updated to refelect FG, EBC etc based on the grain bill.

To limit the grains to your own inventory, select the My Inventory Only option. This will lock out the database and only search malts entered in your inventory.

<figure><img src="/files/XDwtfZ1L2eBifimPumRv" alt=""><figcaption></figcaption></figure>

As the grain bill is calculated, the expected SG, FG, ABV and EBC will be updated in the [**Beer Styles**](#style) section to reflect this. This allows you to change the grain bill to reflect the style or your personal tastes in real time.

### Hops

<figure><img src="/files/rSuSXk6TUXiOOd8su5iV" alt=""><figcaption></figcaption></figure>

This works in the same way as entering Fermentables.  Click the <img src="/files/zV2saE9CKtQjjf4L6IkD" alt="" data-size="line"> **Add Button** and start typing the hop name in the search bar to find the desired hop. Select the hop and enter the **Amount**, **Use** and **Addition Time.** Then select <img src="/files/KL6JJ8Tv7yIZvHgQvzuF" alt="" data-size="line"> to save the hop to the recipe.

* **Amount** - Quantity of Hops&#x20;
* **Use** - Select Boil, Dry Hop, Aroma (Hopstand), Mash or First Wort
* **Addition Time** - this is the time the hops are added (if Boil is slected) or the contact time (other options)
* **Temperature** - enter the temperature the hops should be added if Aroma (Hopstand) is selected

As hops are added, the IBU of the recipe will change to reflect the additions.

### Miscs

The section allows you to add **Miscellaneous** Ingredents to your brew. These can include Brewing Salts, finings, flavour additions etc. There is an included database of common ingredients.

<figure><img src="/files/onCmZuz3ZCMLNoGAE6tY" alt=""><figcaption></figcaption></figure>

### Yeast

Adding Yeast works in the same manner as adding other ingredients. Click the <img src="/files/zV2saE9CKtQjjf4L6IkD" alt="" data-size="line"> **Add Button** and start typing the yeast  name in the search bar to find the desired yeast. Once a yeast is selected the FG and ABV of the reipe willchnage to reflect the expected attenuation based on both grain bill and yeast profile.

<figure><img src="/files/jmsoaRcFJdGT70MXtskU" alt=""><figcaption></figcaption></figure>

### Mash Steps

The Mash Profile can be added in a number of different ways. If you have selected a BrewZilla Profile already, this will be prepopulated with the appropriate steps. You can also create a suitable BrewZIlla Profile in your Profile Library and then select it in the recipe.&#x20;

Otherwise, a Mash Profile can be manually entered, step by step

<figure><img src="/files/sEVzzYsZGA15Wx7GqCby" alt=""><figcaption></figcaption></figure>

Enter a Step Name, Temperature and Step Length, then select <img src="/files/KL6JJ8Tv7yIZvHgQvzuF" alt="" data-size="line"> to save the step. Continue adding steps until the Mash Profile is complete.

If adding Mash Steps manually in the Recipe Builder, once complete you can automatically create a matching BrewZilla Profile using the <img src="/files/YPVVpqKYOHEsIqgg01RA" alt="" data-size="line"> **Convert to BrewZilla Profile** button. The Profile that is created will have the same name as the recipe and will be saved to your My Profiles library with that name, appended with **- Brew**

**NOTE**: If Mash Steps are converted to a BrewZIlla Profile in this manner then Sparge, Pre Boil and Boil steps will be added automatically

### Fermentation

This functions in a very similar manner to [**Mash Steps**](#mash-steps)

The Fermentation Profile can be added in a number of different ways. If you have selected a Fermentation Profile already, this will be prepopulated with the appropriate steps. You can also create a suitable Fermentation Profile in your Profile Library and then select it in the recipe.&#x20;

Otherwise, a Fermentation Profile can be manually entered, step by step

<figure><img src="/files/FVh7bjvjmvbqv2SWCNQg" alt=""><figcaption></figcaption></figure>

Enter a Step Description, Temperature and Step Length, then select <img src="/files/KL6JJ8Tv7yIZvHgQvzuF" alt="" data-size="line"> to save the step. Continue adding steps until the Fermentation Profile is complete.

If adding Fermentation Steps manually in the Recipe Builder, once complete you can automatically create a matching Fermentation Profile using the <img src="/files/YPVVpqKYOHEsIqgg01RA" alt="" data-size="line"> **Convert to Fermentation Profile** button. The Profile that is created will have the same name as the recipe and will be saved to your My Profiles library with that name, appended with **- Fermentation**

### Water

**Water Chemistry** is optional. Many brewers will not use Brewing Salts to adjust their water, and it is not always necessary to create great beer. However, for advanaced brewers or brewers that wish to adjust their brewing water profile there is a powerful and simple to use water calculator in the Editor screen. This is hidden by default - simply select  the dropdown arrow to open the Water Chemistry Calculator.

<figure><img src="/files/wSolibaUfqgqBou44g8c" alt=""><figcaption></figcaption></figure>

For a guide to using the Water Calculator please refer to [**Water Chemistry**](/recipes/my-recipes/water-chemistry.md)

### Notes

Use this section to enter recipe notes if desired.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rapt.io/recipes/my-recipes/recipe-editor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
