Consignment Printing
Print labels for products in your Lightspeed consignments (purchase orders). LabelLight works with open, partially received, and fully received consignments.
Overview
When you open a consignment page in Lightspeed Retail, LabelLight enhances the existing "Print Label" button to use your custom DYMO templates instead of Lightspeed's default printing.
📸 Screenshot: Consignment page showing the Print Label button
How It Works
-
Open a Consignment
Navigate to a consignment page in Lightspeed Retail (e.g.,
yourdomain.retail.lightspeed.app/consignment/...) -
Click "Print Label"
Click the "Print Label" button in the consignment toolbar. LabelLight intercepts this click.
-
LabelLight Modal Opens
The LabelLight printing modal appears with a list of all products in the consignment.
-
Review and Print
Set quantities for each product and click "Print Labels" to print.
Consignment States
LabelLight handles consignments differently based on their status:
📦 Open Consignments
Consignments that have been created but no items have been received yet.
What You'll See
The product list shows all ordered items with their ordered quantity. The "Received" column shows 0 for all items.
Typical Use Case
Print labels in advance before your shipment arrives. When the order comes in, labels are ready to apply.
📸 Screenshot: Open consignment - all items show 0 received
📬 Partially Received Consignments
Consignments where some (but not all) items have been received and marked in Lightspeed.
What You'll See
The product list shows both ordered and received quantities. Some items may show received quantities while others show 0.
Duplicate SKU Handling
In partial consignments, the same SKU may appear multiple times:
- Once for items on the original order
- Once for items received that weren't on the original order
LabelLight preserves all line items so you can print labels for each separately.
LabelLight automatically downloads and parses the consignment CSV export to get accurate received quantities. This ensures the "Received" values match exactly what Lightspeed shows.
📸 Screenshot: Partially received consignment with mixed quantities
✅ Fully Received Consignments
Consignments where all ordered items have been received.
What You'll See
All items show their full received quantity. The ordered and received quantities should match (or received may exceed ordered if extra items were received).
Typical Use Case
Print labels after receiving your complete shipment. All items are ready for labeling and stocking.
📸 Screenshot: Fully received consignment showing all items
Using the Print Modal
When you click "Print Label" on a consignment page, the LabelLight modal appears with the following features:
Product List
The modal displays a list of all products in the consignment with:
- Product Name - The name of the product from Lightspeed
- SKU - The product SKU/code
- Quantity Ordered - How many were ordered
- Quantity Received - How many have been received
- Price - The product price (with your configured currency formatting)
- Labels to Print - Input field to set how many labels to print for this item
📸 Screenshot: Product list showing consignment items
Setting Label Quantities
For each product, you can set how many labels to print:
- Enter a number in the quantity field for each product
- Set to 0 to skip printing that item
- The total label count updates as you change quantities
You can use the "Select All" option to quickly set quantities based on ordered or received amounts.
Label Preview
Hover over any product row to see a preview of how the label will look with that product's data. This uses your configured default template and field mappings.
📸 Screenshot: Label preview appearing on hover
Template Selection
If you have multiple label templates uploaded, use the template dropdown in the footer to switch between them. The preview will update to reflect the selected template.
Exporting Data
Click the "Export CSV" button in the header to download the consignment data as a CSV file. This is useful for record-keeping or processing in other applications.
Printing Labels
-
Set Quantities
Enter the number of labels to print for each product.
-
Select Template
Choose your label template from the dropdown (if you have multiple).
-
Click "Print Labels"
Click the Print Labels button in the footer to start printing.
-
Wait for Completion
A progress indicator shows printing status. Labels are sent to your DYMO printer one at a time.
When printing finishes, you'll see a success message. The modal remains open so you can print more labels or close it.
Fallback to Lightspeed Printing
If LabelLight encounters an error or cannot connect to DYMO, you have the option to fall back to Lightspeed's built-in label printing:
When the fallback option is triggered, LabelLight will redirect you to Lightspeed's native barcode/label printing page at:
/consignment/barcodes?consignment_id=...
This fallback ensures you can always print labels, even if there are issues with DYMO connectivity.
When Fallback Occurs
- DYMO Connect is not running
- No printers are detected (and bypass is not enabled)
- Critical errors during the printing process
- User manually requests fallback via the modal
Troubleshooting Consignment Printing
"Print Label" button doesn't respond
Ensure LabelLight is enabled and you're signed in. Refresh the Lightspeed page and try again.
Products missing from the list
LabelLight uses the consignment's CSV export for accurate data. If products are missing, they may not be in the consignment yet. Refresh Lightspeed and try again.
Received quantities are wrong
Ensure you've properly received items in Lightspeed before printing. LabelLight reads the current state of the consignment.
Data extraction is slow
Large consignments may take a few seconds to load. The modal shows a loading indicator while data is being extracted.
For more troubleshooting help, see Error Messages.