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

# Print a label

> Configure printers, select label templates, and print barcode labels across browser, server, and third-party printing modes.

The **Barcode Label** dialog lets you pick a barcode template, choose a printer, set the number of copies, preview the rendered label, and submit the print job. ION prints over one of two paths, set once for the org; see [print paths](/build-hardware/labels-and-scanning/overview#print-paths). The dialog shows the printer picker for whichever path is configured.

## Prerequisites

Before you print a label, make sure you have:

* Permission to print labels for the entity type you're working with.
* A printer reachable from the printing mode your org uses.
* At least one barcode template configured for the entity type. An admin can add templates in **Settings → Organization → Barcode Labels**.

## Print a label

The Barcode Label dialog opens from the entity you want a label for, such as a part inventory page or any context with a **Print Label** action. The dialog shows these controls and a preview:

* **Barcode Template** picks the barcode format and field layout. Templates are scoped to the entity type, so only valid templates appear.
* **Printer** picks which printer to send to. The picker varies based on org print mode.
* **Number of Label Copies** sets the number of duplicate labels to print (minimum 1).
* The preview has a **QR Code** tab and a **Full Label** tab so you can verify the encoding and the rendered label before submitting.

To print a label:

1. Set **Number of Label Copies**. The default is 1. Use copies when you need multiple identical labels, such as one per kit container or one per face of a packaged unit.
2. Open the **Barcode Template** dropdown and select the format you want. ION pre-selects the first available template. Adjust it if your downstream process expects a different one.
3. Open the **Printer** picker and choose the destination printer. The picker pulls printers from the active mode (browser or print server). If no printers appear, see [Troubleshooting](#troubleshooting).
4. Check the preview. The **Full Label** tab renders the label as the printer produces it, and the **QR Code** tab shows the encoded barcode. Confirm that the barcode and any human-readable fields look right.
5. Click **Print**. The button is disabled until a template with content, a printer, and at least one copy are all selected.

On success, ION shows a `Print job successful` toast. If a print is sent over Zebra Browser Print but the printer doesn't report its status (common over USB), ION shows a `Sent to printer (print not confirmed)` warning instead.

<Tip>
  Set **Number of Label Copies** to 1 for a verification print, then reopen the dialog and print the full quantity. This saves wasted stock when a template is wrong.
</Tip>

## Barcode formats

Each template encodes a specific format. If your scanners need a specific encoding, have an admin configure a template that produces it rather than reformatting it by hand. See [Create label templates](/build-hardware/labels-and-scanning/templating).

<Tip>
  When an admin adds a new template, scan a printed label with the scanner the floor uses. Encoding compatibility isn't always obvious from the preview.
</Tip>

## Troubleshooting

### Failed to reach printer

If the **Printer** picker is disabled and shows **Failed to reach printer**, follow the steps for your print mode:

* **Browser mode**: Confirm Zebra Browser Print is running on the workstation. Click the **Check the status** link next to the picker, which opens `https://localhost:9101/available` in a new tab, to verify the local print service is responding. If the page errors, restart Zebra Browser Print and reload ION.
* **Print server mode**: Confirm the print server is reachable and the printer is registered with the print server. On persistent failure, escalate to an admin to verify print server health.

### Labels print but barcodes won't scan

This is most often a template mismatch, where the template encoding doesn't match what your scanner expects. Try a different template. If no template scans correctly, request a template change from your admin.

### Print started but nothing prints

If ION shows `Sent to printer (print not confirmed)`, check that the printer is powered on and connected. In print server mode, check the print server's job queue to see whether the job is queued, printing, or errored.

<Tip>
  Print one entity at a time. To print across many parts in bulk, ask an admin to configure a print queue or batch flow.
</Tip>