> ## 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.

# Configure barcode labels

> Customize barcode label templates for inventory, kits, and locations in ION.

ION can print barcode labels for inventory items, kits, and locations. Each entity type can have multiple named label templates, and you can optionally connect a dedicated print server.

## Create a label template

1. In ION, go to **Settings > Organization > Barcode Labels**.
2. In the **Label templates** section, select the tab for the entity type you want to configure: **Inventory**, **Kits**, or **Locations**.
3. Click **New Template**.
4. Fill in the template fields:

| Field                     | Description                                                            |
| ------------------------- | ---------------------------------------------------------------------- |
| **Template Name**         | A name to identify this template.                                      |
| **Print density (DPI)**   | Printer DPI setting. Default is 203. Match this to your printer's DPI. |
| **Label height (inches)** | Height of the label in inches. Default is 1.                           |
| **Label width (inches)**  | Width of the label in inches. Default is 3.                            |
| **ZPL Template**          | The label layout written in ZPL (Zebra Programming Language).          |

5. Click **Create Template**.

## Edit a label template

1. In ION, go to **Settings > Organization > Barcode Labels**.
2. Select the tab for the entity type, then select the template you want to edit from the **Templates** list.
3. Update the template fields.
4. Click **Save Template**.

To remove a template, select it, then click **Deactivate**.

### Available template variables

Insert these variables into your ZPL template and ION replaces them with live data when printing:

| Variable                   | Description                                    |
| -------------------------- | ---------------------------------------------- |
| `${partNumber}`            | Part number                                    |
| `${partDescription}`       | Part description                               |
| `${partRevision}`          | Part revision                                  |
| `${serialNumber}`          | Serial number                                  |
| `${lotNumber}`             | Lot number                                     |
| `${quantity}`              | Quantity                                       |
| `${location}`              | Location                                       |
| `${dateCreated}`           | Date the record was created                    |
| `${barcode}`               | Barcode value                                  |
| `${qrCode}`                | QR code value                                  |
| `${activeKitId}`           | Active kit ID                                  |
| `${abomInstallationCount}` | Number of aBOM installations                   |
| `${canceledPoLineCount}`   | Number of canceled purchase order lines        |
| `${createdBy.email}`       | Email of the user who created the record       |
| `${createdBy.id}`          | ID of the user who created the record          |
| `${createdBy.lastLogin}`   | Last login of the user who created the record  |
| `${createdBy.locationId}`  | Location ID of the user who created the record |

## Connect a print server

A print server lets ION send barcode labels directly to a printer without requiring a browser print dialog.

1. In ION, go to **Settings > Organization > Barcode Labels**.
2. Turn on **Use print server**.
3. In the **Print server API key** field, enter the API key for your print server.

To view the existing API key, click **Show**. You need admin access to reveal the key.