Product List Printing - LabelLight Docs

Overview

When browsing your products list in Lightspeed Retail, you can expand any product row to see more details and actions. Lightspeed provides a "Print Label" button in this expanded view. LabelLight intercepts this button to provide custom DYMO label printing.

📸 Screenshot: Products list page with expanded product row showing "Print Label" button

How It Works

Go to Products List
Navigate to your products list in Lightspeed Retail: yourdomain.retail.lightspeed.app/products
Expand a Product Row
Click on a product row to expand it and reveal additional details and action buttons.
Click "Print Label"
In the expanded area, find and click the "Print Label" button. LabelLight intercepts this action.
LabelLight Modal Opens
The LabelLight printing modal appears with the selected product's variants.
Review and Print
Set quantities and print your labels.

Accessing Print Label from Product List

The "Print Label" button in the products list is different from the consignment print button. Here's how to find it:

Step-by-Step

Open Products List
From your Lightspeed dashboard, click on "Products" in the main navigation to open the products list.
Find Your Product
Use search or scroll to find the product you want to print labels for.
Expand the Row
Click anywhere on the product row to expand it. An expanded section appears below the row.
Locate Print Label Button
In the expanded section, look for the "Print Label" button (usually has a printer icon).

📸 Screenshot: Annotated view of expanded product row with Print Label button highlighted

Data Extraction

When you click "Print Label" from the products list, LabelLight extracts product information differently than from other pages:

Variant Detection

LabelLight reads variant information from the expanded row's inventory table. Each variant row is detected and can be printed separately.

What LabelLight Extracts:

Variant ID - The unique identifier for each variant
SKU - Product/variant SKU code
Product details - Additional data fetched from API

API Enhancement

After extracting basic variant information from the page, LabelLight makes API calls to fetch complete product data. This provides access to all fields defined in your field mappings.

💡 Variant IDs

LabelLight uses multiple detection methods to find variant IDs including data attributes, URL patterns, and UUID scanning. This ensures reliable detection across different Lightspeed interface versions.

The Print Modal

The modal for products list printing works similarly to other printing modes:

📸 Screenshot: Print modal showing variants from products list

Modal Contents

Product/Variant List - All detected variants from the expanded row
Quantity Controls - Set label count for each variant
Label Preview - Hover to preview labels
Template Selection - Choose your label template
Print Button - Send labels to printer

Fallback to Lightspeed Printing

If LabelLight encounters issues (DYMO not connected, errors, etc.), you can fall back to Lightspeed's native printing:

⚠️ Lightspeed Fallback

When fallback is triggered from the products list, LabelLight will attempt to simulate a click on Lightspeed's original "Print Label" button. This opens Lightspeed's native print dialog.

How Fallback Works

LabelLight temporarily removes its click handler and triggers the original Lightspeed button action. This ensures you can always print labels even if there are DYMO connectivity issues.

When Fallback May Occur

DYMO Connect not running
No DYMO printers detected
API errors preventing data fetch
User manually requests Lightspeed printing

Products List vs Other Print Methods

Feature	Products List	Product Edit Page	Consignment
Access Method	Expanded row button	Injected button in action bar	Existing "Print Label" button
Products Included	Single product variants	All variants of one product	All products in consignment
Best For	Quick single-product printing	Printing while editing	Bulk consignment labels
Fallback Method	Simulates original click	N/A (button is added)	Redirects to barcode page

Troubleshooting

"Print Label" button behaves like normal Lightspeed

Ensure LabelLight extension is enabled and you're signed in. The extension needs to be active before you load the products page. Try refreshing the page.

No variants detected in the modal

Make sure you expanded the product row before clicking "Print Label". LabelLight reads variant data from the expanded inventory table.

Modal opens but shows empty or loading

This may indicate an API error. Check that your Personal Token is configured and valid. Check the browser console for error messages.

Fallback keeps triggering

Verify DYMO Connect is running and your printer is connected. If the bypass setting is needed, enable it in extension settings.

For more troubleshooting, see Error Messages.