?tab=jobs).
Walkthrough: Labels and printing. Install the desktop app: Set up the printer client. Registering the device is Add a printer. Approving the client is Authorize the printer client.
There is no org-wide jobs list. Jobs always live under one printer at
/dashboard/printers/:id (Jobs tab) or /dashboard/printers/:id/jobs/:jobId.Open Jobs
1
Open Printers
Sidebar Printers. Title Printers, description Manage your printers.
2
Open a printer
Click a row, or the row menu View. The detail URL is
/dashboard/printers/:id.3
Switch to Jobs
Tabs: Overview (
?tab=overview) and Jobs (?tab=jobs). Jobs shows a count badge when the current page of jobs is not empty.
Jobs tab — stats for Pending, Processing, Failed, and Completed, then the jobs table
/dashboard/printers/:id/jobs/create. That route has no screen in the client — use Documents → Print / Print All on a shipment instead. See Shipment printer settings.
Job stats
Shown above the table only when at least one job is returned. Processing counts both Processing and Dispatched.
The table polls every 5 seconds while any job is Pending, Dispatched, or Processing.
Jobs table
Container title: Jobs. Sorted by Created At descending. Pagination is server-side.
Row click opens job detail.
Row menu:
Status filter
On Jobs only, the header filter includes Status. Options: Pending, Dispatched, Processing, Completed, Failed (plus the shared All). Overview has no job filter.Empty state
No print jobs found / Print jobs will appear here once they are created. Button Create Print Job uses the same missing/jobs/create route as the header — print from the shipment instead.
Retry and delete
Retry Print Job. Description: This will retry the failed print job. Are you sure? You must type RETRY. Success toast: Print job retried successfully. Failure: Failed to retry print job. Delete Print Job. Description: This will permanently delete print job {{id}}. This action cannot be undone. Type the first 8 characters of the id in uppercase. Success: Print job deleted successfully. Failure: Failed to delete print job.
Retry Print Job asks you to type RETRY before the job is queued again
Delete Print Job — type the first eight characters of the id in uppercase
Job detail
URL:/dashboard/printers/:id/jobs/:jobId. Title Print Job {{id}} (first 8 characters). Description Created on {{date}}.
Header action: Retry when status is Failed; otherwise Delete when status is Pending or Failed. Completed and in-flight jobs have no header action.
Tabs: Overview, and Document only when documentType is set.
Print job overview — status, type, printer, format, retries, and timestamps
Job Information
Active jobs (Pending, Dispatched, Processing) poll every 3 seconds.
Error Information
Only when the job has an error string. Label Error Message, then the raw error.Metadata
Only when metadata is a non-empty object. Shown as JSON.Document tab
Document Preview — Document Type and Format, then a PDF iframe or image from the job content URL. Headless browsers often leave PDFs blank; use View on the shipment document if you need to read the label.Not found
Print Job Not Found / The print job you’re looking for doesn’t exist or you don’t have access to it.How jobs get created
On a shipment, Documents → Print All (or a row Print) opens Print Documents. Confirming creates jobs and toasts {{count}} print job created or {{count}} document failed to print. If the printer is disconnected, the API can return The printer is offline. (PRINTER_OFFLINE). Missing job: Print job not found. (PRINTER_JOB_NOT_FOUND).
In testenv, printer WebSocket clients do not run, so printers stay Offline and jobs can sit in Pending.