Extension Settings - LabelLight Docs

1. Authentication

The authentication section allows you to sign in with your Google account to verify your LabelLight subscription.

Sign In

Click the "Sign in with Google" button to authenticate. This connects your Google account to your LabelLight subscription.

📸 Screenshot: Google Sign-In Button

After Signing In

Once signed in, you'll see:

Profile Picture - Your Google account avatar
Name - Your Google account name
Email - Your Google account email
Sign Out Button - Click to sign out of your account

💡 Why Google Sign-In?

Google Sign-In provides secure authentication without requiring you to create another password. Your subscription is linked to your Google account for easy access.

2. Language Selection

LabelLight supports multiple languages. The language selector is located in the top-right corner of the settings page.

🌐 Language

Choose your preferred language from the dropdown:

English (US) - American English
English (UK) - British English
Español - Spanish
Français - French

📸 Screenshot: Language Selector Dropdown

The language setting affects all text in the extension interface. Changes apply immediately after selection.

3. General Settings

General settings control your printer selection and currency formatting options.

Printer Settings

🖨️ Default Printer Required

Select your default DYMO printer from the dropdown. This is the printer that will be used when printing labels. If you have multiple DYMO printers connected, you can choose which one to use as the default.

🔄 Refresh Printers

Click the refresh button (circular arrow icon) next to the printer dropdown to rescan for connected printers. Use this if you've connected a new printer or if your printer isn't showing up.

🐛 Bypass Printer Detection Optional

Enable this option if your printer is connected but not being detected. Some versions of DYMO Connect have a bug where printer detection always returns false, even when a printer is properly connected. Enabling this option skips the detection check.

⚠️ When to Use Bypass

Only enable "Bypass Printer Detection" if you're certain your printer is connected and working, but the extension shows "No printers found." Test printing from DYMO Label Software first to confirm your printer works.

📸 Screenshot: Printer Selection Settings

Currency & Formatting

Configure how prices and monetary values appear on your labels.

💱 Currency Symbol

Enter the currency symbol to display on labels (e.g., $, €, £, ¥). Maximum 5 characters.

📍 Currency Position

Choose where the currency symbol appears relative to the price:

Before price - $10.00 (most common for USD)
After price - 10.00€ (common in some European countries)
No currency symbol - 10.00 (displays number only)

🔢 Decimal Rounding

Set how many decimal places to display for prices fetched from the Lightspeed API:

No rounding - Shows exact value from API
2 decimal places - Standard for most currencies (recommended)
3 decimal places - For currencies with smaller units
4 decimal places - Maximum precision

📸 Screenshot: Currency & Formatting Settings

💡 Save Your Settings

Click the "Save Settings" button after making changes to the General Settings section. Changes won't take effect until saved.

4. Personal Token

Personal Token is required for LabelLight to function. The extension uses Lightspeed's API to fetch product data for printing labels.

🔑 Personal Token Required

Enter your Lightspeed personal token. This token authorizes LabelLight to access your Lightspeed product data. The extension will not work without a valid personal token.

⚠️ Required Configuration

The Personal Token is mandatory. LabelLight requires API access to fetch product information from Lightspeed. Without a valid token, you will not be able to print labels.

How to Get Your Personal Token

Log in to Lightspeed Retail
Open your Lightspeed Retail backoffice in Chrome.
Navigate to Personal Tokens Page
Go to https://{YOUR_DOMAIN}.retail.lightspeed.app/setup/personal-tokens

Replace {YOUR_DOMAIN} with your actual Lightspeed domain (e.g., mystore.retail.lightspeed.app).
Create a New Token
Click the button to create a new personal token. Give it a descriptive name like "LabelLight Extension".
Copy the Token
Once created, copy the token value immediately. Important: You won't be able to see this token again after leaving the page.
Paste into LabelLight Settings
Paste the token into the "Personal Token" field in LabelLight settings and save.

📚 Learn More

For more information about personal tokens in Lightspeed Retail, see the Lightspeed support article on personal tokens.

⚠️ Token Security

Your personal token provides access to your Lightspeed data. Keep it secure and never share it publicly. The token is stored securely in your browser's local storage. If you suspect your token has been compromised, revoke it immediately from the Personal Tokens page and create a new one.

💡 Token Management

Personal tokens don't expire automatically, but you can revoke them at any time from the Personal Tokens page. If you revoke a token that's being used by LabelLight, you'll need to create a new one and update it in the extension settings.

📸 Screenshot: Personal Token Section

5. Branding

Add your company logo to customize the appearance of your labels.

🖼️ Company Logo Optional

Upload your company logo to include it on printed labels. The logo can be mapped to image fields in your DYMO label templates.

Uploading a Logo

Click the Upload Area
Click on the dotted upload area or drag and drop your logo file.
Select Your Logo File
Choose a logo file from your computer. Supported formats: PNG, JPG, SVG.
Preview and Confirm
Your logo will appear in the preview area. Click "Remove" if you want to choose a different file.

💡 Logo Requirements

For best results, use a logo with a transparent background (PNG format). Maximum file size: 2MB. Square or landscape logos work best on most label layouts.

📸 Screenshot: Logo Upload Area and Preview

6. Label Templates

Upload your custom DYMO label template files to use when printing. Templates define the layout, size, and design of your printed labels.

Uploading Templates

Click the Upload Area
Click the upload area or drag and drop your template files.
Select Template Files
Choose one or more DYMO template files (.label or .dymo extension). You can upload multiple templates.
Templates Appear in List
Uploaded templates will appear in the list below the upload area.

Managing Templates

Each uploaded template shows:

Template Name - The filename of the template
Set as Default - Mark as the default template for printing
Delete - Remove the template from your list

⚠️ Default Template Required

You must set one template as the default before you can configure field mappings. The default template is used when printing labels.

📸 Screenshot: Label Templates List

For detailed information on creating and customizing label templates, see Label Templates.

7. Field Mappings

Field mappings connect your Lightspeed product data to the text and barcode fields in your DYMO label templates. This section appears after you set a default label template.

💡 Prerequisites

Before configuring field mappings, you must: (1) Upload at least one label template, and (2) Set one template as the default.

💡 Field Mappings Persistence

Your field mappings are preserved when you switch between different default label templates. They are only cleared when you delete a label template from your collection. This allows you to maintain multiple templates with different layouts while keeping your field configurations intact.

How Field Mapping Works

Each text or barcode object in your DYMO template can be mapped to a Lightspeed product field. When you print, the mapped data replaces the placeholder content in your template.

Example Mappings:

Template Field	Lightspeed Data	Result
ProductName	name	Shows the product name
Price	price_including_tax	Shows the price with tax
Barcode	sku	Generates barcode from SKU

📸 Screenshot: Field Mappings Configuration

For a complete guide to field mappings including all available fields, see Field Mappings.

Troubleshooting Field Mappings

⚠️ Problem: I can only see my product name, without any variant options

Solution: Change from the "Product Name" API field to the "Variant Name" API field in your field mappings. The Product Name field only shows the base product name, while the Variant Name field includes the complete name with variant options (e.g., "T-Shirt - Blue - Large" instead of just "T-Shirt").

Saving Your Settings

Each section has its own save button. Be sure to save changes in each section you modify:

General Settings - Click "Save Settings" after changing printer or currency options
Personal Token - Click "Save Token" after entering your Personal Token (required for the extension to work)
Field Mappings - Click "Save Mappings" after configuring your field mappings

✅ Success Messages

After saving, you'll see a success notification confirming your settings were saved. If there's an error, an error message will appear explaining the issue.

⚠️ Minimum Required Settings

To use LabelLight, you must configure at a minimum: (1) A default printer, (2) A valid Personal Token, and (3) At least one label template with field mappings.