Add a printer

You do not add a printer from a form on the web app. The Printers screen lists devices that the Zippendo Printer Client registered. After a printer is Active, you edit its name and type here, turn on Rotate wide pages to portrait, and send jobs with Print All / Print from a shipment. Journey walkthrough: Labels and printing. Install and Sign in with Browser: Set up the printer client. Browser Authorize Printer Client: Authorize the printer client. Job history: Printer jobs. Printers on one shipment: Shipment printer settings.

​

Printer client vs the Printers screen

The list empty state is explicit: No printers yet — Printers will appear here once they are registered from the printer client application. There is no Add printer button in the dashboard.

​

Download the printer client

The header action is Download Printer Client. The menu title is Download for your system. Each row is a direct installer (not a landing page): Sign-in and approval happen in the client and on Authorize Printer Client. See Set up the printer client and Authorize the printer client.

​

Register from the printer client

After you authorize, the client dashboard Printers heading has + Add Printer (empty state: Add Your First Printer). The modal title is Add Printer. Every field is required (the client shows Please fill in all fields if any is empty): Actions: Cancel, Add Printer (busy: Adding…). Use Label Printer for shipping labels (thermal / ZPL). Use Document Printer for packing lists and invoices (usually A4). The same local OS printer can be registered once per type on that client — for example as both Label and Document, but not twice as Label. A new printer lands on Printers with status Pending Approval until someone uses Approve on the row. The client shows Waiting for admin approval. Full approve / reject copy: Authorize the printer client.

​

Stats on the Printers screen

Four cards above the table (loading subtitle Loading printers…): A printer can be Active and Offline at the same time: it is approved, but the desktop app is not connected. Jobs stay queued until the client is online. See Printer offline or not printing.

​

Filters

Open Filters in the header (common.filters). Add filters applies; Clear all filters resets. A search with no match uses the same empty copy: No printers yet / Printers will appear here once they are registered from the printer client application.

​

List columns and row actions

Click a row to open printer detail. Columns: Row menu: API errors the list can surface include Printer not found. (PRINTER_NOT_FOUND) and The printer is offline. (PRINTER_OFFLINE).

​

Edit Printer

Modal id edit-printer-modal. Title Edit Printer. Subtitle Update printer name and type. Save stays disabled until something changes and Printer Name is non-empty. Busy: Saving…. Cancel reverts. Toast: Printer updated successfully / Failed to update printer. There is no rotate control on the label viewer. Rotation is only this switch.

​

Printer detail (Overview)

URL /{org}/dashboard/printers/{printerId}. Tabs use ?tab= (useTabQueryState): Header title is the printer name. Description is the OS name, or Printer • {LABEL|DOCUMENT} if none. Back goes to Printers. Printer Information rows (overview): Not found: Printer Not Found — The printer you’re looking for doesn’t exist or you don’t have access to it.

​

Print All and Print Documents

On a shipment Documents tab (?tab=documents), Print All and each row’s Print create Zippendo print jobs. They do not open the browser print dialog. Labels go to an Active Label printer. Packing lists, invoices, and other non-label files go to an Active Document printer. Zippendo uses the shipping rule’s printers first, then the shipment’s printers. If neither is set, Print Documents opens (modal id printer-select-modal). Warnings when a needed type has no Active printer:

• No active printers found. Please set up a printer first.
• No active label printers found. Please set up a printer first.
• No active document printers found. Please set up a printer first.

Print stays disabled until every shown dropdown has a value. Toasts: 1 print job created / N print jobs created, or 1 document failed to print / N documents failed to print. To save printers on the shipment so this modal is skipped, use Shipment printer settings. To print automatically when you send, use Auto-print labels and documents.

​

Next