Home / Documentation / Product Printing

Product Printing (Edit Page)

Print labels directly from the Lightspeed product edit page. LabelLight adds a "Print Labels" button to the product action bar for quick access to label printing.

Overview

When you're editing a product in Lightspeed Retail, LabelLight automatically injects a "Print Labels" button into the page's action bar. This allows you to quickly print labels for the product you're viewing without navigating to another page.

📸 Screenshot: Product Edit page showing the injected "Print Labels" button in the action bar

Key Features

  • Auto-injected Button - The "Print Labels" button appears automatically on product edit pages
  • Variant Support - All product variants are automatically detected and included
  • API Data Fetching - Full product data is fetched from Lightspeed API using the product's SKU
  • Instant Access - No need to navigate away from the product you're editing

How It Works

  1. Navigate to Product Edit Page

    Open any product in Lightspeed Retail and click "Edit" to access the product edit page. The URL will look like: yourdomain.retail.lightspeed.app/product/[product-id]/update

  2. Look for "Print Labels" Button

    In the action bar (where "Cancel" and "Save" buttons are), you'll see a new "Print Labels" button added by LabelLight.

  3. Click "Print Labels"

    Click the button to open the LabelLight printing modal.

  4. SKU Extraction

    LabelLight automatically reads all SKUs from the product's variant table on the page.

  5. API Data Fetch

    Using the extracted SKUs, LabelLight fetches complete product data from the Lightspeed API.

  6. Review and Print

    Set quantities for each variant and print your labels.

Products with Variants

If your product has multiple variants (e.g., different sizes, colors), LabelLight automatically detects all variants from the product edit page.

How Variants Are Detected

LabelLight reads SKU values from the variant input fields on the product edit page. Each variant with a SKU will appear as a separate item in the print modal.

📸 Screenshot: Product edit page showing variant table with multiple SKUs

What You'll See in the Modal

Each variant appears as a separate row with:

  • Product Name (may include variant name if available)
  • SKU for that specific variant
  • Price for the variant
  • Individual quantity input for each variant
💡 Variant Options

When printing variant labels, you can map variant-specific fields like variant option names (Size, Color, etc.) and values to your label template. See Field Mappings for details.

The Print Modal

After clicking "Print Labels", the LabelLight modal opens with your product(s):

📸 Screenshot: Print modal showing product variants from edit page

Modal Features

  • Product List - All variants detected from the product page
  • Label Preview - Hover over any row to preview the label
  • Quantity Controls - Set how many labels to print per variant
  • Template Selector - Choose which label template to use
  • Export CSV - Export product data for external use

API Data for Product Labels

LabelLight fetches additional product data from the Lightspeed API to provide more fields for your labels than what's visible on the edit page.

Available API Fields

Common fields available for product labels include:

Field Description
name Product name
variant_name Specific variant name
sku Product/variant SKU
supplier_code Supplier's product code
price_including_tax Retail price with tax
price_excluding_tax Retail price without tax
supply_price Cost/wholesale price
brand.name Brand name
supplier.name Supplier name
variant_options[0].name First variant option name (e.g., "Size")
variant_options[0].value First variant option value (e.g., "Medium")

See Field Mappings for a complete list of available fields.

⚠️ Personal Token Required

To access extended product data from the API, you must configure your Personal Token in the extension settings. Without a token, only basic data from the page will be available.

Printing Labels

  1. Review Products

    Verify the correct variants are listed in the modal.

  2. Set Quantities

    Enter how many labels to print for each variant. Set to 0 to skip a variant.

  3. Select Template

    Choose your label template from the dropdown.

  4. Preview Labels

    Hover over rows to preview how labels will look.

  5. Print

    Click "Print Labels" to send labels to your DYMO printer.

Troubleshooting

"Print Labels" button doesn't appear

The button only appears on product edit pages (URLs ending in /update). Make sure you've clicked "Edit" on the product, not just viewing it.

No variants appear in the modal

Ensure your product variants have SKUs assigned. LabelLight uses SKU fields to identify variants. Products without SKUs may not appear.

API data not loading

Check that your Personal Token is configured in settings. Without a token, only basic data visible on the page will be used.

Button appears but nothing happens when clicked

Try refreshing the page. If the issue persists, check that DYMO Connect is running and the extension is signed in.

For more help, see Error Messages.