Scispot now supports seamless integration with Zebra printers, allowing you to print custom label barcodes directly from your LIMS environment. This guide walks you through the setup process and highlights key considerations to ensure smooth operation.
Integration Overview:
Printer Discovery: Zebra Browser Print(ZBP) detects networked Zebra printers automatically, avoiding manual network setup.
Print Execution: ZPL/EPL commands flow securely from your browser to the printer without exposing your network.
Template Management: Design once, upload anywhere—templates stored in scispot make label updates a breeze.
You’ll learn how to connect your web app to Zebra printers on your local network quickly and securely, with no deep technical background required.
1. What is Zebra Browser Print?
Zebra Browser Print is a small desktop app from Zebra Technologies. It connects your web browser to Zebra label printers on the same local network, so you can print labels directly without changing firewall settings.
https://www.zebra.com/ap/en/support-downloads/software/printer-software/browser-print.html
Why use it?
Simple setup: Install one app and go.
Secure: No need to open your network to the internet.
Fast: Prints over your local Wi‑Fi or Ethernet.
2. How do I install Zebra Browser Print?
Download the installer from Zebra’s official website. https://www.zebra.com/ap/en/support-downloads/software/printer-software/browser-print.html
Run the installer and follow the on‑screen steps. Turn on the Driver Search option.
Trust the security prompt when it appears.
Check for the Zebra icon in your system tray (Windows) or menu bar (Linux).
3. What do I need before starting?
Computer: Windows 10/11 or a common Linux version. Please check the supported version here: https://www.zebra.com/ap/en/support-downloads/software/printer-software/browser-print.html
Printer: A network‑connected Zebra label printer (e.g., ZD, GK, ZT series). Printers that support ZPL files.
Supported Drivers: Download proper drivers for your printers from here: https://www.zebra.com/us/en/support-downloads/printers.html
Network: Your computer and printer must be on the same network.
Browser: Prefer Google Chrome (others may block local apps).
ZPL Designer Tool: Zebra Designer Essentials for designing zpl templates or any other available tool.
4. How to setup this Integration and connect Zebra Browser Print to Scispot?
Use Scispot’s built‑in Zebra Printing Integration page:
Open Integrations: In Scispot, click your profile icon (bottom-left) and select Integrations, then click Zebra.
Enable Integration: If it's not already enabled, click Enable, and confirm your Scispot workspace.
Trust the security prompt when it appears. It'll allow scispot app to communicate with your zebra printers.
Check Connection: Under Printer Status, verify it shows “Connected to Zebra Browser Print.” If not, ensure the ZBP desktop app is running.
Select a Printer: Scroll to Available Printers, click on a printer entry (e.g., ZDesigner iMZ220 (ZPL)), then click Test to send a test label. A green Ready indicator confirms it’s working.
Add or Refresh Printers: Click Refresh to rediscover printers at any time.
Tip: Keep the Zebra Browser Print app open whenever you plan to print from Scispot.
Label Templates: What, Why, and How
What are label templates?
Label templates are reusable layouts—written in Zebra’s ZPL format—that define how your labels look. They include elements like barcodes, text, logos, and placeholders for dynamic data.
Why use templates?
Consistency: Ensure every label matches your brand and data format.
Efficiency: Design once, then print hundreds without redesigning.
Flexibility: Insert variables (e.g., {{scispot.labsheet.sampleId}}) to personalize each label automatically.
Creating a new label template:
Click + New template above the template list.
Fill in:
Template Name: A clear, descriptive title.
Template Type: Choose the relevant category (e.g., Inventory Item, Sample Tube).
Description (optional): Notes or usage hints.
ZPL Template Code: Paste your ZPL or .prn contents. Use {{variable}} syntax for dynamic fields.
(Optional) Click Refresh Preview to see how your label will look.
Click Create to save.
Editing an existing template:
In the Label templates list, find the template and click Edit.
Update the fields or ZPL code as needed.
(Optional) Use Refresh Preview to confirm changes.
Click Update Template to apply your edits.
Can I preview the labels template before printing?
Yes! Scispot supports previewing of label templates based on your ZPL content.
Note: We recommend test-printing your label template a few times before regular use to ensure everything aligns perfectly. Minor adjustments to the ZPL may be needed for optimal print quality.
How do I design and use label templates?
Designing templates ahead of time ensures consistent, professional labels every time. You’ll first create your template in a ZPL tool, then upload it to Scispot.
a. Choose your design tool
Zebra Designer Essentials (Windows): Free from Zebra.com.
Other ZPL tools: Labelary, BarTender, NiceLabel, or any software that can export ZPL (.prn).
Note for Mac Users: Zebra Designer isn’t supported on macOS. Use a ZPL-compatible alternative that runs on your platform.
b. Create a new label in Zebra Designer Essentials
Launch Zebra Designer Essentials and click Create New Label.
Select Printer: Choose your Zebra model (e.g., ZD420) and click Next.
Set Page Size: Pick the correct media size (e.g., 50mm x 50mm) and click Next.
Orientation: Choose Portrait or Landscape, then Next.
Dimensions & Finish: Confirm width, height, and margins, then click Finish to open the design canvas.
c. Add barcodes and text in Zebra Designer
Add a Barcode:
On the left toolbar, click Barcode, then drag onto the canvas.
In the Properties panel, set Data Source to Text and enter {{item_barcode}}.
Add Text Fields:
Click Text in the toolbar, drag to place.
For labels like item name or date, type static text or insert placeholders (e.g., {{item_name}}).
In Font settings, select a Zebra font (e.g., Zebra OS Font) for static text.
Insert Logo (Optional):
Click Graphic → Picture, choose your logo file, and position it.
Adjust Layout:
Use alignment guides to center objects.
Resize and space elements evenly for clarity.
d. Export to ZPL
Go to File → Print (or Export).
Check Print to file or Export as .prn.
Set printer speed (lower is clearer) and darkness (15+ recommended).
Click Print to generate your .prn file containing ZPL code.
e. Upload and use in Scispot
In Scispot’s Zebra Integration page, scroll to Label templates and click + New template.
Enter your Template Name and Type.
Open the .prn file in a text editor, copy all ZPL, then paste into ZPL Template Code.
(Optional) Click Refresh Preview to see a render.
Click Create to save.
To print, select this template in your label action—Scispot will merge real data into your placeholders and send ZPL to the printer via ZBP.
Dynamic Placeholders for Scispot Data
Question 1: How do I insert labsheet data into my label?
Answer: Use the {{scispot.labsheet.column_name}} syntax, where column_name matches one of your labsheet columns. Currently supported column types are TEXT, ID, NUMBER, LIST, STATUS, DATE AND LOCATION.
Example: {{scispot.labsheet.sample_id}}, {{scispot.labsheet.description}}, {{scispot.labsheet.quantity}}, or {{scispot.labsheet.status}}
Question 2: How can I display the name of a manifest or box?
Answer: Use {{scispot.manifest.name}}. This placeholder fetches the manifest’s or box’s name directly.
Question 3: What placeholder shows the human-readable ID of a manifest?
Answer: Use {{scispot.manifest.hrid}} to display the manifest’s human-readable ID (HRID).
Question 4: How do I include the actual barcode value on any label?
Answer: Use {{scispot.label.barcode}}. This works for labsheets, manifests, boxes, or well plates to show the generated barcode value.
Question5: Can I mix static text and placeholders?
A: Yes. For example: Product: {{scispot.labsheet.product_name}} will show “Product: ” followed by the dynamic value.
Example: Adding placeholders in Zebra Designer Essentials
In Zebra Designer Essentials, select Text and drag it onto the canvas.
In the Properties panel under Data Source -> Text, enter: Item ID: {{scispot.labsheet.sample_id}}
Add a Barcode object and in Data Source, enter: {{scispot.label.barcode}}
Optionally, add another Text object for a manifest name: Manifest: {{scispot.manifest.name}}
Use Preview in Scispot or Refresh Preview on the templates page to verify these placeholders render correctly with real data.
How to print Label Barcodes to Zebra Printers from Labsheets?
To use Zebra printers as a printing method in Labsheets, ensure the following are set up in your Scispot account:
Zebra Integration Enabled
Zebra integration must be enabled for your account. If it's not, follow the setup instructions provided above. Also, make sure Zebra Browser Print is running on your system during printing.Label Templates Configured
Set up your label templates with the necessary placeholders you want to include in the final label output.Printer Connection Verified
Ensure your printers are connected to Scispot and that you've successfully tested the connection before printing.
Step 1: Select the samples from Labsheets for which you want to print labels. Then, click the Printer icon in the floating toolbar to begin the printing process.
Step 2: A prompt will appear asking for permission to allow Scispot to communicate with your Zebra printers. If you’ve already granted this permission during the integration setup, you won’t see it again—this is a one-time process. Click Yes to allow access.
Step 3: Change the Print Gateway from Manual Print to Zebra Printer. Select the ZPL template you want to use, and choose the printer where you’d like to send the print command.
Please note: Label previews are only rough representations of the expected output. The final print may vary based on your printer’s configuration. If the preview fails to load, it doesn’t necessarily mean the actual print will fail—your labels will still print correctly as long as your template and placeholders are properly set up.
Note: We recommend test-printing your label template a few times before regular use to ensure everything aligns perfectly. Minor adjustments to the ZPL may be needed for optimal print quality.
Step 4: You can now click the Print button to send a command to your selected printer. This command includes the final ZPL file, which the printer will convert into barcode labels.
A Few Important Points:
Verify Printer Connectivity and Configuration
Before proceeding with final printing, ensure your printer is properly connected and configured. Double-check settings such as page layout, darkness, and print speed—these are managed on your printer and not controlled by Scispot.Print in Small Batches
Always print in small batches and wait for the printing process to complete before refreshing the page or closing the browser. Interrupting the session can disrupt the print commands and lead to incomplete prints.