Benchling supports printing labels for any box, plate, container, or registered entity you track. You can upload ZPL (Zebra Programming Language) label template code into Benchling, which enables you to print labels with information about items in your tenant. There are three components to label printing:

  • The inventory item (box, plate, container) or registered entity that you want to print a label for. This is where the information printed on the label is taken from.

  • The label template. This determines where data is displayed on the label.

  • The printer. This is where the label is physically printed.

This article covers:

Create a label template using Zebra Designer

With Benchling, you can upload ZPL label templates, which you can design using a number of label design programs. Zebra Designer Pro (V3) is free and provided by Zebra, but any software that can produce ZPL should be compatible. When designing your labels, you can use keywords that Benchling recognizes to pull in data related to the item on to the label.

Note: Zebra Designer Pro is not compatible with macOS. To run the Zebra Designer software on a Mac, you need an emulator, like a virtual box, PaperSpace, or another program that generates ZPL files.

Upload your label to Benchling

After your ZPL-formatted label is complete, upload it to Benchling:

  1. Click your avatar in the bottom-left corner.

  2. Under Feature Settings, click Registry Settings.

  3. Select Label Printing in the left-side menu, then click Create Label Template.

  4. Enter the label template name and the ZPL for your label.

  5. Click Create.

Keywords recognized by Benchling

Keywords are all formatted as benchling.<item type>.<property>. For example, benchling.container.barcode or benchling.entity.Cell Count. The table below lists what properties we support for which items.

Property

Entity

Container

Box

Plate

Location

name

x

x

x

x

x

registry_id

x

barcode

x

x

x

x

created_at

x

x

x

x

x

current
_datetime

x

x

x

x

x

schema

x

creator

x

x

x

x

x

creator
_initials

x

x

x

x

x

volume

x

concentration

x

location ²

x

x

x

x

location_path³

x

x

x

x

location_with_coordinates

x

x

x

x

<schema field>

x

x

x

x

x

1. The barcode for a registered entity is its registry ID.

2. The location property prints the name of the direct parent location of the inventory item.

3. The location_path property prints the full location path of the inventory item.

4. The location_with_coordinates property prints the immediate parent location name, but when the container is in a box or matrix plate it prints coordinates instead of a numeric position. For example, Box A:B2 instead of Box A:12.

5. To print the schema field value, use the display name of the schema field. For example, benchling.entity.Cell Count. If this field isn't found on the entity, the value stays blank.

Note on entities in containers: You can use benchling.entity.<property> when printing container labels to print information about the entity stored within the container you selected to print a label for. If a container contains multiple entities, only the data on the first entity will be used.


Related topics

Configure printers for label printing

Creating label templates using Zebra Designer

Preview label templates in Benchling

Printing labels for registered entities

Printing labels for storage

Did this answer your question?