Install the app
To use the Printlane Designer, you need to install the Printlane for Lightspeed app from the Lightspeed App Store
📥 Install: Printlane on Lightspeed App Store
Note: The app is currently only available for Lightspeed stores created in Belgium, The Netherlands or Germany.
Activate your account
After installing the app, you will receive an email to activate your account. Click the activation link in the email and set a password for logging in.
Didn’t receive an activation email? Contact Printlane Support for assistance.
Enabling the designer for products
To ensure the designer recognizes a product as customizable, each customizable product must have a custom field attached. This field serves the following purposes:
Identifies whether a product is customizable
Stores the customer’s design
Allows the customer to edit their design from the shopping cart
Retrieves the design after an order is placed
Instead of creating this field separately for each customizable product, you can create a custom field group to reuse across products.
1. Create a custom field group (once)
Log into the Lightspeed back-office
In the navigation menu, click Products.
Click Extra Fields.
Name the custom field group Design, then click Save.
Click Add Field to create a new text field within the group.
Name the field
printlane(all lowercase), set it as non-required, and leave the character limit unrestricted.Click Save.
The custom field group is now ready and can be applied to products that need personalization through the Printlane Designer.
2. Enable the designer for a product
For each customizable product, you need to attach the custom field group to enable the Printlane Designer:
Log into the Lightspeed back-office
Edit a product and scroll to Stock and Variants.
Ensure each variant has an article number—this number must match a template in Printlane Studio.
Add or edit a variant and enter its article number.
Scroll down to Extra Fields.
Click Use Field Group, then select the Design group you created earlier.
Save the product.
The product is now ready for customers to customize. Repeat these steps for each customizable product.
Important: Ensure the article numbers you use match existing templates in Printlane Studio. If a product does not have a corresponding template, the designer will still open but display a “Product Not Found” error.
Opening the designer on the product page
Once the app is installed and the custom field is added to a product, visit the product detail page in your store. The Add to Cart button should now display as Customize. Click Customize to open the Printlane Designer.
Did the button not change to “Customize”? Please contact Printlane Support for assistance.
Using multiple variants
The default implementation supports multiple product variants. For each variant, enter its corresponding Printlane template ID:
Note: All variants must be customizable. If you need to exclude certain variants, please contact Printlane Support.
Using custom fields to determine which Printlane template to use
If you wish to change the template based on a a choice made in a custom field, you If you need to change the template based on a custom field selection, the default implementation won’t work. Lightspeed only allows template IDs for variants, not custom fields.
In this case, you need to integrate Printlane using JavaScript in your theme. Example:
var templateId = 'iphone-template';
// The add to cart button on the page
var addToCartButton = document.querySelector('.add-to-cart');
// A select to choose a value from the Lightspeed custom field
var chooseColorSelect = document.querySelector('select.choose-color');
// Callback to open designer
function openDesigner() {
printlane.open({
shop: 'your-store-id',
product: templateId,
callback: function() {
// Remember the Printlane reference
document.getElementById('printlane-reference').value = id + '.' + token;
// Close the designer
printlane.close();
// Submit the product to the shopping cart
document.getElementById('form-add-to-cart').submit();
}
});
}
// Helper functions to enable or disable the designer
function enableDesigner() {
addToCartButton.innerHTML = 'Customize product';
addToCartButton.addEventListener('click', openDesigner);
}
function disableDesigner() {
addToCartButton.innerHTML = 'Add to cart';
addToCartButton.removeEventListener('click', openDesigner);
}
// Listen to changes in the select
chooseColorSelect.addEventListener('change', function(e) {
// Disable designer
disableDesigner();
// Get the selected color
var selectedColor = e.target.value;
// Non customizable colors
if (selectedColor === 'white') {
return; // Exit early
}
// Update the template ID to match the color
templateId = 'iphone-template-' + selectedColor;
// Enable designer
enableDesigner();
});
Since this integration depends heavily on your theme and how custom fields are rendered, Printlane does not provide custom development services to modify the example above. However, we’re happy to validate your integration once it’s implemented.
If you want to integrate Printlane using JavaScript for more flexibility, contact Printlane Support.
If you need help from an expert to setup the Javascript implementation in your theme, you can find Lightspeed experts here.
Creating and changing designs
If the designer opens on your product page, customize the product to your liking and click on the Add to cart button. The designer will close automatically and you will be redirected to the shopping cart.
Your shopping cart now displays the customized product along with a Change Design link. To modify the design:
Click Change Design.
Make your changes in the Printlane Designer.
Click Save to update the design.
How to find a design when an order is placed
Every customized order line has a unique Printlane Design reference. For example: 42450.15bd7c88-77b3-4a87-9a46-ad1b8a443452
To find the Printlane reference:
Open the order in the Lightspeed back-end.
Locate the order details.
Look for the Printlane reference in the line items, which appears as:
printlane: 42450.15bd7c88-77b3-4a87-9a46-ad1b8a443452Copy the number before the dot: 42450.
To find Design 42450 associated with the order line:
Log into your account in Printlane Studio.
Navigate to the overview of designs
In the Search by ID filter, enter the Printlane reference (e.g., 42450) and press Enter.
Did you know you can also look up orders in Printlane Studio? This section shows all orders containing at least one order line with a design reference. Orders and order lines without design references are not stored in Printlane due to data processing regulations.