## ION Barcode Label Printing Documentation

ION can print barcode labels for inventory items, kits, locations, and runs. 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**, **Locations**, or **Runs**.
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**.

The Barcode Labels editor: entity tabs and template list on the left, the ZPL template and Available Fields variable list in the center, and the print/size settings below.

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