> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eventsbadge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Printer settings

> Pick a label size preset or set a custom width and height. The canvas, the preview, and every print use the same dimensions.

Badge bakes everything the layout needs (label size in millimeters, element positions, font sizes) into the template, then renders it for the connected printer at print time. This page covers the **Label size** control in the left sidebar, where you either pick a preset or type in custom dimensions. Printer maintenance lives in the **Printer settings** dialog beside **Print test**.

> [!NOTE]
>
> **Before you start**
>
> * A Badge template open in the editor. See [Template editor](https://docs.eventsbadge.com/templates/editor-overview.md).
> * The actual label stock you'll print on, so you can match its dimensions.

## Pick a label preset

Open the **Label size** dropdown in the left sidebar. Four common Zebra presets are pre-loaded:

| Preset | Width × Height (mm) |
| - | - |
| 3 × 2 in | 76.2 × 50.8 mm |
| 4 × 2 in | 101.6 × 50.8 mm |
| 4 × 3 in | 101.6 × 76.2 mm |
| 4 × 6 in | 101.6 × 152.4 mm |

The canvas resizes immediately when you pick a preset, and every element on the canvas keeps its absolute position in millimeters. A name field anchored 10 mm from the top stays 10 mm from the top on a 4 × 2 label and on a 4 × 3 label. If any elements sit off-canvas after resizing, re-position them.

**Recommended default:** 4 × 2 in. It gives you three or four lines of text plus a QR code at a readable size, fits Zebra direct-thermal label rolls that are widely available, and prints fast on a 203-dpi printer.

## Set a custom size

For label stock that doesn't match a preset, type the width and height directly into the **Width (mm)** and **Height (mm)** fields under the dropdown. The canvas resizes as you type, and the **Label size** dropdown shows `Custom: <W> × <H> mm` while a custom size is active.

The minimum dimension is 2 mm. Use millimeters even if your label stock is sold in inches. The editor stores dimensions in millimeters internally and maps them to the printer's resolution at print time.

## Match the loaded label stock

The single most common cause of a misaligned or blank print is a template size that doesn't match the label stock loaded in the printer. Before printing for the first time at an event:

**1. Measure the loaded label**

Take one label off the roll and measure width and height in millimeters with a ruler. Don't trust the box. Labels are sometimes labeled in nominal inches that round down.

**2. Set the same size in the template**

Pick the matching preset, or type the measured millimeters into **Width (mm)** and **Height (mm)**.

**3. Print a test from the editor**

Click **Connect printer**, pick your Zebra in the browser permission dialog, then **Print test**. The badge prints on a single label with no overflow and no blank space.

If the test print runs onto a second label, prints blank, or shifts diagonally, open [Calibration and troubleshooting](https://docs.eventsbadge.com/printer-setup/calibration-troubleshooting.md) for the calibration recipe.

## What the template carries to the printer

When you save a template, Badge renders those exact dimensions into a printer-ready document at print time and sends it to the printer. That means:

* **Label dimensions** drive the print width and the layout grid. Every element's `x`, `y`, `width`, and `height` are converted from millimeters to printer dots.
* **Element bindings** (name, company, ticket, QR) are filled in per attendee at print time, but their positions and sizes come from the template.
* **Per-printer settings stay on the station.** Calibration, reset, and factory defaults run from the **Printer settings** dialog next to **Print test** in the editor, or from the **Printer** tab of the station's **Settings** dialog. Set **Printer DPI** (152, 203, 300, or 600) on each station to match the printer it drives.

Every station renders the same template from the same millimeter dimensions, so a badge lands at the same physical size on any paired printer at the event.

## Related

* [Template editor](https://docs.eventsbadge.com/templates/editor-overview.md). Open the editor, anatomy, save and undo.
* [Add elements](https://docs.eventsbadge.com/templates/add-elements.md). Text, image, QR, and rectangle element properties.
* [Connect a printer](https://docs.eventsbadge.com/printer-setup/webusb-connection.md). Pair a Zebra printer from your browser to test print from the editor.
* [Calibration and troubleshooting](https://docs.eventsbadge.com/printer-setup/calibration-troubleshooting.md). Fix size mismatches, misalignment, and blank prints.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.