# Library

![](https://771697612-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LEzhWP2LGeXaKgS2qr4%2F-Lnb8VZDHxXPlsssfIgC%2F-Lnb8W57N5X5Jlxza6s6%2Fimage.png?alt=media\&token=8ce24c1a-101f-43fd-a656-443ce72a1a1c)

The **Library** page is Brewfather’s public recipe community.

Use it to discover recipes, compare brewing stats, open full recipe details, and copy recipes into your own account.

## Open Library

In the app menu, open **Library** (route: `tabs/community`, page title: **Recipe Library**).

## Search and browse

At the top of the page, use **Search recipe library**.

What you’ll see in each result card:

* Recipe name and style
* Author handle (with profile type styling)
* Tags (when available)
* Key stats: **ABV, OG, FG, IBU, Color**
* Community stats: upvotes, views, downloads

Tap any recipe card to open the full viewer.

### Search scope

Text search matches visible recipe text, including:

* Recipe name
* Style
* Tags
* Profile name (author handle)

### Result loading

Library loads results progressively:

* Starts with a limited result set
* Loads more automatically as you scroll

## Filter recipes

Use the filter button in the top-right corner.

### Numeric filters

* ABV
* IBU
* Color (shown in your selected color unit)
* OG
* FG

### Facet filters

* Type
* Style
* Origin
* Tags
* User
* Country
* Profile Type
* Equipment
* Fermentables
* Hops
* Miscellaneous
* Yeasts

Each facet includes per-value counts. Some facets also support in-filter search.

### Style conformity filter

Enable **True to style** to only show recipes marked as style-conforming.

### Active filters

When filters are active:

* A badge shows total active filters
* Active filters appear as chips above results
* Tap a chip to remove that filter
* Use **Reset Filters** to clear everything

## Sort results

Available sort modes:

* Most relevant
* Last updated
* Upvoted
* Views
* Downloads

## View and copy recipes

Open a result to access the full recipe viewer.

From there you can:

* Review complete recipe details
* Vote up/down
* Share the recipe link
* Report image (if needed)
* **Copy** the recipe to your own account

### Copy behavior

When copied, Brewfather creates a private recipe in your account (not public by default).

If you are on the free tier, recipe count limits still apply when copying.

## Share your own recipe to the Library

To publish your own recipe:

1. Open your recipe
2. Tap the lock/eye public toggle in the recipe toolbar
3. Confirm sharing
4. Fill required sharing fields:
   * **Teaser text** (20–140 characters, no links)
   * **Origin**: Original, Clone, or Official
   * Confirmation checkbox

### Requirements

* All users can browse, open, and copy public library recipes
* You need an active paid subscription to publish recipes
* Sample/default recipes cannot be made public

### Validation

Only recipes that pass public-library validation are shown in Library search results.

If a recipe is public but invalid, Brewfather shows the validation issues directly in the recipe page so you can fix them or make the recipe private.

## Public Profile

A public profile is required before you can share recipes publicly.

### Where to create/edit it

* **Account** page → Create/Edit Public Profile
* Automatically prompted the first time you try to publish without a profile

### Profile fields

Required:

* Profile image
* Brewery name
* Profile name (handle)
* Country

Optional:

* City
* Bio
* Opt-in to upcoming sharing features

### Profile name rules

* 5–28 characters
* Lowercase letters, numbers, `_` and `.`
* Checked for availability before save
* Can be changed **once per month**

When you change your profile name:

* A one-month cooldown starts before the next change
* The old name is released and may be claimed by others
* Your public recipes automatically show the new handle

## Match copied recipes to your equipment

After copying a recipe, open **Change equipment**, select your own equipment profile, and save/scale so Brewfather recalculates targets and ingredient amounts for your setup.

Before brewing, double-check:

* Hopstand temperature alignment between the copied recipe and your equipment profile
* Water adjustments in the water calculator for your own source water
* Yeast pitch in the yeast calculator (especially if you prefer whole-package counts)

## Practical workflow example

1. Search for a style (for example: “Pilsner”).
2. Narrow with filters (ABV/IBU, style, ingredients).
3. Sort by **Upvoted** or **Downloads**.
4. Open a promising recipe and tap **Copy**.
5. Run **Change equipment** and scale for your own system.
6. Re-check water and yeast calculations before brewing.

## Related docs

* [Recipes](https://docs.brewfather.app/recipes)
* [Recipe Designer](https://docs.brewfather.app/recipes/designer)
* [Import Recipes](https://docs.brewfather.app/getting-started/import-recipes)