Home / Documentation / Error Messages

Error Messages Guide

This guide explains common error messages you may encounter when using LabelLight, along with solutions to resolve them. Errors are grouped by category for easy reference.

Initial Loading Errors

These errors may appear when the LabelLight print modal is first loading. The modal performs several checks to ensure everything is ready for printing.

🔐 Google Account Required

Message: "Please sign in with your Google account to use LabelLight."

Cause: You are not signed in to LabelLight with your Google account, or your session has expired.

Solution:
  1. Click the LabelLight extension icon in Chrome toolbar
  2. Click "Sign in with Google" button
  3. Complete the Google authentication process
  4. Return to Lightspeed and try printing again

📋 Subscription Required

Message: "An active subscription is required to print labels."

Cause: Your LabelLight subscription has expired, was cancelled, or you haven't subscribed yet.

Solution:
  1. Visit the Pricing page to subscribe or renew
  2. Ensure your payment method is valid
  3. After subscribing, sign out and sign back in to refresh your subscription status

⏰ Subscription Expired

Message: "Your subscription has expired. Please renew to continue using LabelLight."

Cause: Your subscription period has ended and needs to be renewed.

Solution:
  1. Visit the subscription management page in your LabelLight profile
  2. Click "Renew Subscription" or update your payment method
  3. Once renewed, the extension will automatically reactivate

DYMO Connection Errors

These errors relate to the connection between LabelLight and the DYMO Connect software on your computer.

🔌 DYMO Connect Not Running

Message: "Please ensure DYMO Connect software is installed and running."

Cause: DYMO Connect (or DYMO Label Web Service) is not running on your computer, or the service has crashed.

Solution:
  1. Check your system tray/menu bar for the DYMO icon
  2. If not visible, launch DYMO Connect from your Start menu or Applications folder
  3. Wait a few seconds for the service to start
  4. Click "Retry Connection" in the LabelLight modal

📸 Screenshot: DYMO Connect icon in system tray

⏱️ DYMO Connection Timeout

Message: "DYMO environment check timed out - DYMO Connect may not be running."

Cause: LabelLight couldn't connect to DYMO Connect within the timeout period (10 seconds by default).

Solution:
  1. Restart DYMO Connect software
  2. Check that no firewall is blocking DYMO's local web service (port 41951)
  3. Restart your browser and try again
  4. As a last resort, restart your computer

🌐 DYMO Web Connect Unavailable

Message: "The DYMO Web Connect application is not available."

Cause: DYMO Connect's web service component is not responding. This is the service that allows web applications to communicate with DYMO printers.

Solution:
  1. Make sure you have DYMO Connect installed (not just DYMO Label)
  2. Download DYMO Connect from DYMO Support
  3. Reinstall DYMO Connect if necessary
  4. Check Windows Services to ensure "DYMO Label Web Service" is running

📚 DYMO Framework Not Loaded

Message: "DYMO framework library has not been loaded properly."

Cause: The DYMO JavaScript framework failed to load in the browser.

Solution:
  1. Refresh the page and try again
  2. Clear your browser cache
  3. Disable other extensions temporarily to check for conflicts
  4. Reinstall the LabelLight extension

Printer Errors

These errors relate to detecting and communicating with your DYMO printer.

🖨️ No Printers Found

Message: "No DYMO printers detected. Make sure your printer is connected and DYMO Connect is running."

Cause: No DYMO printers were detected by the DYMO service.

Solution:
  1. Check that your DYMO printer is connected via USB
  2. Ensure the printer is powered on
  3. Verify the printer appears in DYMO Label Software
  4. Try the "Refresh Printers" button in settings
  5. If the printer is connected but still not detected, enable "Bypass Printer Detection" in settings

❌ Printer Not Found

Message: "The printer '[printer name]' was not found or is not available."

Cause: The printer you selected is no longer available. It may have been disconnected or turned off.

Solution:
  1. Check the printer connection
  2. Refresh the printer list in settings
  3. Select a different printer if available

📴 Printer Offline

Message: "The printer '[printer name]' is not connected or is offline."

Cause: The printer is in an offline state, possibly due to connection issues, paper jam, or power issues.

Solution:
  1. Check the printer's LCD display for error messages
  2. Verify USB connection is secure
  3. Check for paper jams or empty label rolls
  4. Turn the printer off and back on

🚫 No Printer Selected

Message: "Please select a DYMO printer from the dropdown."

Cause: No default printer has been selected in extension settings.

Solution:
  1. Open LabelLight extension settings
  2. In "General Settings", select your printer from the dropdown
  3. Click "Save Settings"

Label Template Errors

These errors relate to label templates and their configuration.

📝 No Label Templates Uploaded

Message: "No label templates uploaded. Please upload a label template in settings."

Cause: You haven't uploaded any DYMO label templates to LabelLight.

Solution:
  1. Open LabelLight settings
  2. Go to "Label Templates" section
  3. Click the upload area and select your .label or .dymo template files
  4. Set one template as the default

⚠️ No Label Template Selected

Message: "No label template selected. Please select a label template in settings."

Cause: You have templates uploaded but haven't set one as the default.

Solution:
  1. Open LabelLight settings
  2. Go to "Label Templates" section
  3. Click "Set as Default" next to your preferred template

🔍 Label Template Not Found

Message: "Selected label template not found. Please select a different template in settings."

Cause: The template you had selected as default has been deleted or is corrupted.

Solution:
  1. Open settings and re-upload your template file
  2. Or select a different template as default

❓ No Field Mappings Configured

Message: "No field mappings configured for this label. Please configure field mappings in settings."

Cause: Your label template has text/barcode fields, but you haven't mapped them to Lightspeed data.

Solution:
  1. Open settings and go to "Field Mappings" section
  2. For each field in your template, select the corresponding Lightspeed data field
  3. Click "Save Mappings"

📄 Invalid Label Format

Message: "Invalid label format: root element must be DieCutLabel."

Cause: The uploaded file is not a valid DYMO label template, or it's for an unsupported label type.

Solution:
  1. Ensure you're uploading a file created with DYMO Label Software
  2. The file should have a .label or .dymo extension
  3. LabelLight works with die-cut labels (not continuous tape)

API & Data Errors

These errors relate to fetching data from Lightspeed's API.

🔑 Personal Token Not Configured

Message: "Personal Token not configured. Please configure in settings."

Cause: You haven't entered your Lightspeed API Personal Token in settings.

Solution:
  1. Obtain your Personal Token from Lightspeed (see Personal Token)
  2. Open LabelLight settings
  3. Paste the token in the "Personal Token" field
  4. Click "Save Token"

🚫 Invalid Personal Token

Message: "The provided Personal Token is invalid or has expired."

Cause: Your Personal Token is incorrect or has expired.

Solution:
  1. Obtain a fresh Personal Token from Lightspeed
  2. Personal Tokens can expire - you may need to get a new one periodically
  3. Update the token in extension settings

🌐 Lightspeed Domain Not Detected

Message: "Lightspeed domain not detected. Please refresh the page."

Cause: LabelLight couldn't determine your Lightspeed store domain.

Solution:
  1. Make sure you're on a Lightspeed Retail page
  2. Refresh the page
  3. The URL should be in the format: yourdomain.retail.lightspeed.app

📡 API Request Failed

Message: "Failed to fetch data from Lightspeed API. Please check your Personal Token and try again."

Cause: The API request to Lightspeed failed due to network issues, server errors, or authentication problems.

Solution:
  1. Check your internet connection
  2. Verify your Personal Token is correct and not expired
  3. Try refreshing the page and attempting again
  4. Check Lightspeed status for any service outages

📦 No Products Found

Message: "No products found to print."

Cause: The API returned no products, or the product extraction from the page failed.

Solution:
  1. Ensure you're on a page with products (consignment, product edit, or products list)
  2. Check that products have SKUs assigned
  3. Verify your Personal Token has permission to access product data

Print Errors

These errors occur during the label printing process.

🚫 No Labels to Print

Message: "No labels to print. Please set quantity for at least one product."

Cause: All product quantities are set to 0.

Solution:
  1. Set the quantity to 1 or more for at least one product
  2. Or use "Select All" to set quantities for all products

❌ Print Failed

Message: "Failed to print label: [error details]"

Cause: An error occurred while sending the label to the printer.

Solution:
  1. Check the specific error message for details
  2. Ensure the printer has labels loaded
  3. Verify the printer is not jammed
  4. Try printing a test label from DYMO Label Software

General Troubleshooting Tips

💡 When in Doubt

Try these steps in order when encountering any error:

  1. Refresh the Page

    Many issues can be resolved by simply refreshing the Lightspeed page.

  2. Check DYMO Connect

    Ensure DYMO Connect is running and your printer is connected.

  3. Verify Extension is Signed In

    Click the extension icon and confirm you're signed in with Google.

  4. Check Settings

    Verify your printer, template, and Personal Token are all configured correctly.

  5. Restart Browser

    Close and reopen Chrome to reset the extension state.

  6. Contact Support

    If problems persist, contact support@labellight.com with details about the error.

← Previous: Product List Printing
Next: FAQ →