# Library

![](/files/-Lnb8W57N5X5Jlxza6s6)

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](/recipes.md)
* [Recipe Designer](/recipes/designer.md)
* [Import Recipes](/getting-started/import-recipes.md)


---

# 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.brewfather.app/library.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.