BrewForge Docs

Label templates

Create a label template in BrewForge's label designer. Choose a Niimbot label size or a custom size, add text with brew placeholders like beer name, ABV and batch number, add your brewery logo and position everything in millimetres.

A template is the layout of a label: its size and shape, and the texts and logo on it. Texts can contain placeholders such as {{name}} or {{abv}}, which are replaced with the values of the brew you print for.

Create a template

On Labels, click New template in the Templates section.

Choose how to start: New, or Copy a template to start from one you already have. For a copy, pick the template and check its name.

For a new template, enter a Name and click the Label size to pick your roll (see below).

Click Create. The template opens in the designer, starting with two texts: the beer name and the style.

The New label template dialog with name and label size

The designer

The designer shows the label on the left, at a size you can work with (the line under it gives the actual size). On the right is the list of elements, or the settings of the element you selected.

The label designer: a text selected on the preview, its settings on the right

The designer saves every change by itself; the line under the title shows Saving…, then Saved. Undo and Redo next to the title step back and forward through your changes. If a change can't be saved, the line says so and offers Retry; leaving the page then asks first.

The ⋯ menu has Rename…, Duplicate (a copy named "… (copy)") and Delete template. After deleting, Undo in the message at the bottom brings the template back. Print takes you to the Labels page with this template chosen.

Label size

Click the Size row under Label. The list holds the Niimbot rolls of the B series (B1, B21, B3S) and the D series (D11, D101, D110) with the number of labels per roll; type to search. Choose Custom size for any other roll and enter Width and Height (5 to 100 mm, in 0.5 mm steps) and the Shape (Round or Rectangle). Elements keep their position when the size changes, so check the preview afterwards.

The label size list with the Niimbot rolls

Text elements

Click + Text to add a text, or click a text on the preview or in the Elements list to select it. Its settings appear next to the preview; All elements goes back to the list.

  • Content: the text. The buttons under Insert a brew value add a placeholder at the end. You can mix placeholders and your own words, for example Batch #{{batch}} or {{abv}} % · {{ibu}} IBU.
  • Font: Inter, DM Sans, Source Serif 4, Playfair Display, JetBrains Mono or Caveat.
  • Size (pt), Weight (Normal or Bold) and Align (Left, Center, Right). Changing the alignment moves the text to the matching edge or the centre.
  • X and Y (mm): the position on the label, measured from the top left corner. X is the point the text is aligned to: with center alignment the text is centered on X. The buttons next to the fields snap the text to the left edge, the center or the right edge, and to the top, the middle or the bottom.

Remove in the element's bar deletes it (Undo brings it back).

Placeholders

ButtonPlaceholderFilled with
Beer Name{{name}}The brew name, or the Name on label you type when printing
Style{{style}}The brew's style
ABV %{{abv}}ABV with one decimal, without the % sign
IBU{{ibu}}IBU, rounded to a whole number
OG{{og}}Original gravity in your gravity unit (for example 12.4°P)
FG{{fg}}Final gravity in your gravity unit
Batch #{{batch}}The brew's batch number
Brewer{{brewer}}The brewer name of the brew
Brew Date{{brew_date}}Brew date
Packaging Date{{packaging_date}}Packaging date

ABV, IBU and gravities are the same values the brew shows: measured values where you entered them, otherwise the recipe's. Dates and decimals follow your app language. A placeholder whose value the brew doesn't have (no packaging date yet, for example) prints empty.

Preview with under the preview chooses what the preview shows: Sample values, which you can edit, or A brew of yours. This only changes the preview; printing uses the brew you choose on the Labels page.

Click + Logo to add the brewery logo from Settings → General → Brewery (upload it there first; without one, a note links to Settings). A label can have one logo. Set its Width, Height, X and Y in mm, or use the snap buttons. Label printers print in black only, so a logo with clear contrast works best.

Move elements precisely

With an element selected, the arrow buttons under the preview move it by 0.5 mm per click. The arrow keys do the same, and Esc lets go of the element.

From millimetres to printer dots

BrewForge draws the label at the printer's resolution:

dots = round(mm ÷ 25.4 × DPI) for sizes and positions, and pixels = points ÷ 72 × DPI for font sizes.

Example: a 50 mm wide label on a 203 DPI printer is round(50 ÷ 25.4 × 203) = 400 dots wide; 8 pt text is 8 ÷ 72 × 203 = 22.6 dots tall.

The DPI comes from the connected printer; if it doesn't report one, BrewForge uses 203. The background is always white. Source: apps/web/lib/labels/render.ts, apps/web/lib/niimbot.ts.

On this page