WooCommerce Lightspeed POS

WooCommerce Lightspeed POS allows you to integrate and import inventory from Lightspeed to WooCommerce and sync inventory across both systems.

This extension requires a Lightspeed account.
If you do not have one, you can sign up for a free Lightspeed trial account here.

Installation ↑ Back to top

  1. Download the .zip file from your WooCommerce.com account.
  2. Go to: WordPress Admin > Plugins > Add New to upload the file you downloaded with Choose File.
  3. Activate the extension.

More information at: Installing and Managing Plugins.

Concept ↑ Back to top

Before we get started, here is a little theory to help you understand what kind of sync relationship this extension establishes.

The sync scenario: ↑ Back to top

It is helpful to know the difference between a 1-way and 2-way sync scenario. This extension sets up a 1-way sync scenario. What does that ensue? Here is a rough concept draft of it:

Initial Setup 1-way sync (available) ↑ Back to top

  • WooCommerce is empty, no products.
  • Lightspeed is full, many products.
  • Lightspeed fills WooCommerce with products. Initial Import (See next: Load Products from Lightspeed POS).
  • WooCommerce sells products and feeds inventory changes back to Lightspeed
  • Product management is done in Lightspeed for all values that are synced by the extension: Price, images etc. while WooCommerce provides the beautiful storefront.

This is what defines a 1-way sync scenario using this extension to sync Lightspeed with your WooCommerce store: Lightspeed overrules / manages WooCommerce product inventory while WooCommerce feeds selected info (sales, inventory) back to it. We try to depict this in our little header graphic.

Due to the fact that Lightspeed is the deciding factor in this system, we call Lightspeed the “Source of Truth”.

The whole scenario is not a 2-way sync in a way that:

Initial Setup 2-way sync (not available) ↑ Back to top

  • WooCommerce has some products
  • Lightspeed has some products
  • WooCommerce and Lightspeed get scanned and compared upon each sync or import request
  • Products that match on both sides get linked to each other
  • Products missing on either side get copied over

With that in mind, lets begin with the initial import.

Setup and Configuration ↑ Back to top

1. Go to: WooCommerce > Settings > Integration > WooCommerce Lightspeed POS Integration.

2. Click the Connect to Lightspeed button:

WooCommerce Lightspeed POS settings page

3. Log into Lightspeed, and click the Authorize Application button when redirected to the Lightspeed Retail page:

Lightspeed Authorization Screen

4. Confirm your site when the WooCommerce API connector requests it:

WooThemes API Connector

Once confirmed, you’ll be redirected to your site. If authorization completed successfully, a success message and your store name will appear on the Settings page:

Lighspeed Authorization Success

Multi-store configuration ↑ Back to top

This extension can read but not sync multiple stores from your Lightspeed account. You must set one primary inventory source for WooCommerce.

  1. Tick the checkbox(es) of stores from which you want to import products.
  2. Tick the primary inventory store – this is the store that the plugin will use to sync inventory to and from.
  3. Save changes.
Multistore setup
Multi-store setup
Note: WooCommerce by default does not support multiple inventory locations. If you have multiple Lightspeed stores, you must designate one of them as your primary “inventory” store that the plugin will use to read inventory values from as well as sync inventory values to. 

Set the default state of an imported product ↑ Back to top

In the settings page, you can designate the default status of the product upon import:

This will apply to all products on import. Variation products will inherit the status from their parent matrix/variable product. This means that even if the setting is set to “Draft”, newly added variation products will go straight to a “Publish” status if their parent product is already live and published. Also note that upon installation the default status is set to “Draft”.

Auto-loading New Lightspeed Products ↑ Back to top

There is an option “Product auto-loading (LS -> WC)” located at WooCommerce -> Settings -> Integrations.

Once you activate and successfully save the option, the following is true:

  • On this page `/wp-admin/admin.php?page=lightspeed-import-page` which is the Lightspeed import page.
  • Any item newly added to Lightspeed will be listed in the import page without having to reimport all items from Lightspeed by hitting the “Re-Load products from Lightspeed” button.

Up until version 1.4.9 you needed to reload all products from Lightspeed to be able to see new items in the import table using the “Re-Load products from Lightspeed”. Activating this setting automates the process.

You will need to be on v1.4.9+ for this to be available. Go to WooCommerce -> Settings -> Integrations to enable this feature:

When new products are added to Lightseed, you will be notified in WooCommerce that they were added:

Note: this feature is not enabled by default.
Note: when auto-loading matrix products, the matrix “parent” product needs to have at least one variation (child) products in order for the auto-loading event to pick up the matrix “parent” product and have it displayed in the Lightspeed import table.
Note: this feature run via an Action Scheduler job that runs every 30 seconds. If you want to run the job manually, you can go to Tools -> Scheduled Actions, click on the “Pending” option at the top, and click on the “run” link under the “check_for_new_ls_prods” job.

Action after auto-loading products

If the “Product auto-loading (Lightspeed to WooCommerce)” setting is enabled, then you will also have the option to select what action to take after a product is auto-loaded. You have three options:

  • Do nothing – do not perform any action
  • Import – Import the auto-loaded Lightspeed Product into WooCommerce – but do not actively sync it
  • Import & Sync – Import the auto-loaded Lightspeed Product into WooCommerce –  and actively sync it
Note: new products are added to the Action Scheduler queue and will not be imported immediately. Please be patient and wait for the Action Scheduler to process the queue!

Selective Sync ↑ Back to top

As of v1.5.3 you can now select which product properties should get updated for WooCommerce products that are actively being synced.

Selective Sync from Lightspeed to WooCommerce Products

On an initial import for of a Lightspeed product into WooCommerce, all the product properties will be present, however on subsequent updates the Selective Sync settings allow you, for example, to only have “Stock Quantity” and “Regular Price” and “Sale Price” be synced from Lightspeed on a sync event. All other properties will not be overwritten! This can be useful if you want to publish products in WooCommerce without the sync event overwriting images, descriptions, etc that you may have setup in WooCommerce but not Lightspeed.

Selective Sync From WooCommerce to Lightspeed Products

Once a product is imported from Lightspeed into WooCommerce, you can select which properties of a WooCommerce product should sync back to Lightspeed when you update the product in WooCommerce. This means the properties in Lightspeed will be overwritten once you update a WooCoomerce product via the product page in the admin dashboard.

Differences between “Stock Quantity (manual updates)” and “Stock Quantity (non-manual updates, e.g. orders)”:

The “Stock Quantity (non-manual updates)” setting corresponds to manually updating a WooCommerce Product’s inventory level via the admin product page.

The “Stock Quantity (non-manual updates, e.g. orders)” setting corresponds to a stock quantity updated as a result of a customer’s order or a refund. With this property enabled, the plugin will automatically push updates to Lightspeed to update the corresponding Lightspeed product’s inventory levels.

Note: that selective sync settings will apply globally to all WooCommerce products that are being actively synced!

Ignore Archived Lightspeed Products ↑ Back to top

You can tell the plugin to ignore archived items upon loading them into the import table. This is a setting in the Lightspeed Settings page:

This means all of your archived items in Lightspeed will not show up in the Lightspeed import table in WooCommerce.

Usage ↑ Back to top

Load Products from Lightspeed POS ↑ Back to top

Once setup and configuration are complete and API settings are initialized, Lightspeed POS products can be loaded.

  1. Go to: WooCommerce > Lightspeed.
  2. Click the Load Products from Lightspeed button.
Note: It may take a few minutes to finish. Please be patient. The extension will first load products and then matrix products.

WooCommerce Lightspeed POS first loads products without making them live on your WooCommerce store. This allows you to pick and choose which products to import.

Import and Sync Products from Lightspeed POS ↑ Back to top

Once products are loaded from Lightspeed POS, your screen should populate a table with products. For example:

WooCommerce LightSpeed POS Import Page with LightSpeed Products
WooCommerce Lightspeed POS Import Page with Products

There are five actions that can be performed on products loaded from Lightspeed:

  • Import & Sync – Imports the product on your WooCommerce store and marks it as a “synced” product. What does this mean? Your product is now available in WooCommerce >> Products. It is published and visible in the front end. Also a sync link relationship is now established. The WooCommerce product and it’s Lightspeed source product are now linked to each other. The extension installs an Action Scheduler job that runs every five seconds, to ensure that items with established sync links are added to the sync list. Products are checked against Lightspeed for any changes every five seconds and additionally on these events. If a product has not changed in the last five seconds, then it will not trigger a sync event.
  • Import – Makes the product live on your WooCommerce store, but doesn’t attempt to sync it with Lightspeed later. No sync link relationship is  established.
  • Sync – Establishes a sync link with its corresponding Lightspeed product. If a product has not been imported, it cannot be synced.
  • Update – Pulls all Lightspeed data and immediately updates the WooCommerce product linked to it. Caution: This will override attributes of live products in your store!
  • Delete – Removes a product from the table of loaded Lightspeed POS products.
Note: If you import a product and update later, data from Lightspeed will override the corresponding product in your WooCommerce Store. Use the Update action with caution!
Note: Mistakes happen. We recommend to keep frequent database updates, so you can rollback when you synced one time too much. Open a support ticket if you need assistance with this.

Matrix/variable product support ↑ Back to top

In Lightspeed, “Matrix Products” are equivalent to WooCommerce’s “Variable Products“. We recommend you read the documentation on both platforms before using this plugin because these concepts take some time to learn. Both of them.

On the Lightspeed page, Matrix items have a “stacked” look, which is different from single items. It displayed a “-” for the SKU and inventory columns. Importing and syncing Matrix items is the same as importing single items.

Note: While Lightspeed counts each Matrix item as one separate item, WooCommerce does not. It bundles together variable products as one thus the product count in WooCommerce and Lightspeed will be different if you use matrix products.

Importing Matrix/variable products ↑ Back to top

When importing a Matrix product from Lightspeed into WooCommerce, a new variable product is created and the following properties are downloaded and automatically generated:

Syncing with Matrix items is straightforward. Whenever inventory is set for variation items, it pushes that data to Lightspeed. Also, every five seconds a sync job will pick up on any changes made to variations in Lightspeed and then proceed to update the variations in WooCommerce.

Note: The plugin will automatically set the stock status of a variation product to “In stock” if the inventory is greater than zero.

Import all products

If you want to mass import products, click Import All Products into WooCommerce:

Note: Importing all products can take time, depending on how many you have. Do not close the browser window until complete, or you need to start over. As stated above: Import – Makes the product live on your WooCommerce store, but doesn’t attempt to sync it with Lightspeed later. No sync link relationship is  established.

Categories ↑ Back to top

WooCommerce Lightspeed POS also allows you to import product categories with one click. Go to your Lightspeed settings located at WooCommerce >> Settings >> Integrations and click on “Import Lightspeed Categories”.

Version 1.4.7 has full category support. However when setting up your categories do keep in mind that this is a one time import. Categories are not synced continuously nor are they removed in your WooCommerce store when they are removed in your Lightspeed.

Subcategories ↑ Back to top

Subcategories that share the same parent category (so called sibling categories) must have unique category names.
While Lightspeed allows sibling categories to have identical names, WordPress does not. In WordPress each slug (URL path) must be unique. Make sure that subcategories that share the same parent all have unique names.

Tags ↑ Back to top

Tags are imported with the first sync from Lightspeed to WooCommerce.

Product categories ↑ Back to top

Due to the nature of this manual import, product categories are only applied not removed. The sync does add active categories to products, but so far it does not remove obsolete ones, when you remove them on the Lightspeed side.

Send Products from WooCommerce to Lightspeed POS ↑ Back to top

When using this extension you should initially create your products in Lightspeed and then create them in WooCommerce by importing them. However you can send WooCommerce products that are already created and missing on the Lightspeed side to Lightspeed from the product detail page as a one-time initial setup step.

To do this, click the Sync with Lightspeed button in the Lightspeed Settings meta box on the right side:

Sync with Lightspeed button
Sync with Lightspeed button

This creates the product in Lightspeed with the following data points sent over:

  • SKU – this will show up under the “Custom SKU” field in Lightspeed
  • Images (gallery and single images are supported)
  • Inventory
  • Price – regular price and sale price are supported

After this the sync relationship defaults to Lightspeed being the source of truth. The WooCommerce product will not continue to send these values from WooCommerce to Lightspeed but will be managed by the Lightspeed side as long as the sync link is active. See the “Import and Sync” action for more information on sync links.

Note: The Lightspeed API only allows a max of 3 attributes for matrix items. If you are trying to sync over a WooCommerce product with more than 3 attributes, the plugin returns an error. We are still pondering over this. Developers, if you have any feedback we would love to hear it.
Note: If you get an Internal Server Error then your installation makes use of too many custom fields. Syncing to Lightspeed initially to create the product in Lightspeed automatically will not work. You must create the product in Lightspeed as intended and then import it to WooCommerce.

Manual Sync ↑ Back to top

You can trigger a manual product sync by either visiting your Lightspeed import page and using the “Update” function there.

Or by using the “Manual Update via Lightspeed” button located in the sidebar with each single product view in the WooCommerce backend.

Action Scheduler Jobs ↑ Back to top

Two new recurring action scheduler jobs will be added once the plugin is active:

  1. wclsi_poll – this is the Poller that runs every 5 seconds to check for any changes in Lightspeed items such as inventory changes, image updates, and other generic updates like description changes.
  2. check_for_new_ls_prods – runs every 30 seconds and checks for newly created Lightspeed items

You can trigger these jobs manually whenever you’d like by going to Tools -> Scheduled Actions and click on the “Pending” category:

WooCommerce Lightspeed POS Action Scheduler Jobs
WooCommerce Lightspeed POS Action Scheduler Jobs

Relinking ↑ Back to top

Sometimes a WooCommerce product may lose its link to its corresponding Lightspeed product for various reason (e.g. a user error caused the Lightspeed product to be deleted from the Lightspeed import table).

The “Relink with Lightspeed” button re-establishes this link by looking up the Lightspeed product based off the SKU value using the following logic: if the Lightspeed product already exists in the Lightspeed import table, then it will try to re-establish the link there first, otherwise it will make an API call to Lightspeed and see if there are any products that match the SKU. If there is a match, then it will try and re-establish the link that way.

Relinking WooCommerce Products and Lightspeed Products

The “Relink with Lightspeed” button is located under the “Lightspeed Settings” metabox on the product page.

Database Structure ↑ Back to top

The following tables are installed upon activation (with wp_ being the prefix):


wp_wclsi_items stores most essential info such as:

  • id a general item id to identify a product within the WooCommerce Lightspeed plugin tables.
  • item_id the item id used by Lightspeed.
  • wc_prod_id the post id used by WooCommerce. NULL if product has not been imported to WooCommerce.
  • wclsi_import_date shows date and time of the import. NULL if not imported.
  • wclsi_last_sync_date shows date and time of the import. NULL if never synced.
  • wclsi_is_synced shows 1 if a product has an active sync link to Lightspeed from WooCommerce. NULL if product is not linked from WooCommerce to Lightspeed.
The “Last updated”: information on the WooCommerce Lightspeed import page pulls info from date and time info that is set in the Lightspeed account. Not from the local server, not from WordPress.
Developers: This makes querying datasets simpler. For example:
SELECT * FROM wp_wclsi_items WHERE wc_prod_id IS NULL
gives you all products in your WooCommerce store that are not linked to a Lightspeed product.

Current Release ↑ Back to top

WooCommerce Lightspeed version 1.6.6 – see the changelog for full details.

The current release includes:

  • Tweak – Optimization improvements utilizing wp_object_cache (thank you Xavier)
  • Tweak – Moves the poller to Action Scheduler, allowing manual runs of syncing as well as reduced 429 errors
  • Fix – Removes WCLSI_Cache_Lock class, should fix any database duplicate errors
  • Fix – Deletes categories from the wp_wclsi_item_categories table when the corresponding categories in WooCommerce are deleted
  • Fix – Fixes an issue during Lightspeed authentication where the tokens do not get parsed correctly

If you have current issues please open a support ticket with us, to access the most current development version which fixes outstanding issues.

Read before updating ↑ Back to top

  • The most important step is to take a full backup. You must be prepared to rollback using a backup. Test your rollback first, before you update! An untested backup might still leave you stranded.
  • Your sync links and all other data prior to the update will be preserved. However we recommend three important steps besides a backup: testing, testing, testing. If you need assistance, please open a support ticket with us and we will guide you through the update process.

Software Requirements ↑ Back to top

These software settings are required to run WooCommerce Lightspeed without issues.

  • PHP 7 or higher,
  • MySQL 5.6 or higher,
  • PHP Max Execution time of 300s or higher.
  • WordPress CRON active
  • WooCommerce 3 or higher
  • A valid and correctly configured SSL certificate

You can use this plugin: WP-Serverinfo to check your environment settings.

For editing PHP parameters, please see this blog post.

Recommended Hardware ↑ Back to top

A WooCommerce shop, like every eCommerce platform, needs some serious hosting. Here is a recommendation so you can run this extension with your WooCommerce store smoothly.

  • Private Dedicated Server.
  • Processor: Intel® Xeon® E5-2680V4 or better.
  • RAM: 24 GB DDR4 RAM (ECC) or better
  • Disks: 120 GB SSD / 960 GB SAS – RAID 10

Integrations ↑ Back to top

General ↑ Back to top

All releases of this plugin get tested thoroughly with the current WooCommerce and WordPress version at the time of the release. No other plugin combinations are tested, therefore you should not assume automatic integration with other plugins. Here is a list of missing integrations that are frequently requested:

Missing integrations ↑ Back to top

  • GoDaddys inhouse plugins seem to be not compatible with the upcoming 1.4.3 release, they must be disabled.
  • This extension is not WordPress Multisite compatible.
  • This extension does not support Windows server. Use on Windows on your own risk.
  • This extension does not support WPML.
  • This extension does not support Archive, Layaway or backorders.
  • This extension does not support custom taxonomies of any kind. For example: WooCommerce  Brands and Lightspeed Brands are not supported. We recommend to setup Brands as categories instead.
  • Multiple stores can be read but are not supported for syncing data. If you have multiple Lightspeed stores, you must designate one of them as your primary store that the plugin will use to read inventory values from as well as sync inventory values to.
  • This extension does not sync sales data. Only inventory changes are sent. WooCommerce order data is not sent over.
  • Product Vendors  is not supported.
  • Lightspeed eCom is not supported.
  • Caching is not supported. Any Varnish, object or other cache must exclude all WooCommerce product pages, cart and checkout.

FAQ ↑ Back to top

Sync triggers ↑ Back to top

Products that are ticked to be synced will automatically trigger an inventory check with Lightspeed during the following events:

  • Before a customer views a product page
  • Before a customer adds a product to the cart
  • Before a customer checks out

On the final step before checkout a last check is triggered. If the Lightspeed inventory is zero then the checkout process will be halted and an “out of stock” error should be displayed to your customer.

Inventory changes in WooCommerce are also pushed to Lightspeed. For example, whenever an order is complete or inventory is added to a product, those changes are made in Lightspeed.

Can we sync / import products selectively for example by category only? ↑ Back to top

This feature is on our roadmap but not available yet. If you know code and can develop customizations you can take a look at the https://github.com/rafdizzle86/woo-lightspeed-customizer.

Categories are missing or incomplete when importing products. ↑ Back to top

Please our section on subcategories and the limitations with sibling categories.

Lightspeed API Error – 403 Not Authorized – “To continue, please complete the CAPTCHA below” ↑ Back to top

This error can happen if your Lightspeed backend is locked via a pin and the account you used to connect your Lightspeed to WooCommerce falls under this restriction. Either remove the pin or use your full Lightspeed account for connecting your Lightspeed to your WooCommerce store.

Another reason this error can happen is due to Lightspeed’s Cloudflare firewall. We would recommend to read this article and coordinate with your hosting company and Cloudflare to resolve the 403 error.

What about fields like short and long description and shipping dimensions? ↑ Back to top

Lightspeed used to offer these fields in their free Web Store feature. This has been replaced by “eCom”. While these fields are still available to you upon request via Lightspeed support, we have confirmation that these might be removed in the feature. We recommend using WooCommerce only for entering your short and long description and measurements.

The error “Unable to resolve api.merchantos.com” frequently comes up. ↑ Back to top

Lightspeed throttles their API requests to 40 requests per minute, which can result in temporary disconnection from their API. Wait a minute, and retry the action you were trying to perform.

“Lightspeed API Error – 429 Rate Limit Exceeded: Please decrease your request volume. ↑ Back to top

The WooCommerce Lightspeed extension runs a WordPress Action Scheduler job every five seconds which checks and collects WooCommerce products that need to be updated during your main sync cycle. The Lightspeed API imposes a limit of API calls, that your store may execute. In order to abide by this we use Javascript to distribute the amount of API calls of your store within the restrictions of Lightspeed’s API.

If you see the error “Lightspeed API Error – 429 Rate Limit Exceeded: Please decrease your request volume” than it is probably because either:

  • You have been using “manual sync” a bit too much in which case, slow down please ;).
  • Or you are syncing variable products with a lot of images and variations, which makes it difficult for our script to distribute your stores API calls evenly.

My Lightspeed is slow, not responding, not connecting. ↑ Back to top

If you experience continuous Lightspeed performance problem, it might be a good idea to also check the status of Lightspeed.

Do WooCommerce backorders get synced? ↑ Back to top

WooCommerce Backorders are not supported at the moment. We are investigating whether Lightspeed is able to handle this and if yes how we can implement this.

How is the price synced? ↑ Back to top

The WooCommerce product price is controlled and managed by what you set in Lightspeed as “Default” price. As of v1.4.8 “Sale” prices can be synced as well. However be careful when activating the sale price on the Lightspeed side. Lightspeed will automatically fill in all “Sale” price values with what you set for “Default” prices. This means that on sync with WooCommerce, all of your WooCommerce products will have their “Sale” price value set. Prior sale prices you set in WooCommerce will be overwritten when you sync. This will not trigger them to go on sale in WooCommerce, but your WooCommerce sale prices will all get overwritten.

Lightspeed API Error – 404 Unknown PriceLevel Sale ↑ Back to top

Lightspeed by default does not have a Sale Price. You will have to set this up in order to sync these values back and forth between WooCommerce and Lightspeed.

In Lightspeed go to Settings >> Pricing levels.

Click on “New Pricing Level” and name it “Sale”. Exactly “Sale”.
Not “sale”, not “sales” or “Sales”. Please take note of our warning above for “How is the price synced?

The sync doesn’t seem like it’s working. ↑ Back to top

WooCommerce Lightspeed requires WordPress CRON to be active. Check whether your wp-config.php file has DISABLE_WP_CRON constant set to true. Furthermore check whether your WooCommerce product is linked to the Lightspeed instance. Go to the product detail page and find the Lightspeed settings meta box.

If you see this:

Then there is no sync link established. Which means your WooCommerce product and Lightspeed product are not talking to each other. You can delete the product from your WooCommerce store and recycle bin and then re-import from Lightspeed to put the sync link back in place.

The product count / amount in WooCommerce and Lightspeed are different. ↑ Back to top

While Lightspeed counts each Matrix item as one separate item, WooCommerce does not. It bundles together variable products as one thus the product count in WooCommerce and Lightspeed will be different if you use matrix products.

A previously imported product no longer shows up in the Lightspeed Import Page. ↑ Back to top

For this we recommend deleting the WooCommerce product instance and removing it from the recycle bin. After this simply re-import from Lightspeed.

Variable Products outofstock in backend

Sometimes variable products display as outofstock in your WooCommerce Products overview at /wp-admin/edit.php?post_type=product: 

You can try and set a default variation to solve this issue:

You can use any variation as default variation.

Variable Products are not displayed in the front-end dropdown ↑ Back to top

Try the following as a first step:

  • Pick any variable products which is not displayed fully in your front-end dropdown.
  • Create a new product manually, create some variations manually similar to your problematic product. Does it display ok?

If it does: Delete the problematic product and create the product manually anew fully. In this case you probably had some corrupt database entry which you replaced successfully by writing the data manually. After this delete the new manually created product fully, also from your recycle bin and re-import from Lightspeed if you need the sync link as well.

If it fails:

  • Go to: /wp-admin/edit.php?post_type=product&page=product_attributes and create the products attributes there.
  • Create the attribute names:

  • Create a test product and create the variations using those created attributes instead of creating the attributes within the product.

This should work. Now repeat this for all other attributes and variable products or re-import from Lightspeed if you need the sync link as well.

Does WooCommerce Lightspeed support [fill in plugin name]? ↑ Back to top

Not at the moment. Please see our section on integrations for more information.

The Sync says Pending… ↑ Back to top

This indicates that no syncing of data has been performed from Lightspeed to WooCommerce but is scheduled. Trigger a manual update if you do not want to wait. Every item that is newly imported will be set to pending sync status, until there was an inventory update.

My product description does not get synced over but it is entered in Lightspeed notes ↑ Back to top

The Lightspeed notes field is for internal use only. These fields will not get synced over. You need to use the following fields in Lightspeed for your product description:

If you cannot see the “Web Store” menu item, you need to activate it by going to Settings >> Getting Started. Or directly: https://us.merchantos.com/firststart.php

Here is the video tutorial by Lightspeed POS to get you started: https://www.lightspeedhq.com/webhelp/retail/webstore/en/content/setting-up-web-store/installing-webstore.html

In Lightspeed “Web Store” is not the same as eCom which is described here: https://www.lightspeedhq.com/ecommerce/pricing/

Activating it should not trigger any additional fees. If you are unsure about this, ask your Lightspeed support. To our knowledge Lightspeed uses both terms interchangeable especially in the documentation which makes it hard to maintain an overview of what is what.

How do you update product photos? ↑ Back to top

The photos are pulled in from Lightspeed upon import. You can change them on WooCommerce but they won’t synchronize back to Lightspeed because of the nature of the sync scenario. However if you change them on Lightspeed and select the “Update” action, then photos should be updated on your WooCommerce store.

How can I update product categories? ↑ Back to top

Right now category updates are only imported once. We currently do not support category updates but this feature is on our roadmap.

Does this integration support multiple Lightspeed stores? ↑ Back to top

Yes. This integration has been improved to support multiple LightSpeed stores. We are currently in the process of updating our extension to allow for inventory syncing across multiple store locations. Even though you can import products from different stores, inventory syncing will only occur across one store – most likely the first store that is listed in the Lightspeed settings page.

Does this work with Lightspeed Retail? How about other versions? ↑ Back to top

Yes, this integration works with the Retail cloud-based product only. It does not work with Lightspeed Onsite (server based) or Lightspeed Restaurant (does not integrate with WooCommerce). Additionally this extension does not support Lightspeed eCom, all eCom features must be unavailable.

Can I duplicate / copy products using a plugin or WooCommerce? ↑ Back to top

No. This feature is not supported. Please import or create the product in WooCommerce anew instead.

Does Lightspeed connect and sync automatically to the same WooCommerce product upon import if it is already created in my WooCommerce store? ↑ Back to top

No. Lightspeed will not automatically detect the “right” product in your WooCommerce store because of the nature of a 1-way-sync scenario. Upon import a new WooCommerce product will be created. Instead you should either delete the WooCommerce product and then import & sync from Lightspeed.

What happens when there’s a change (e.g., stock) in my Lightspeed account? ↑ Back to top

Unfortunately Lightspeed’s integration does not send notifications whenever there are changes in a Lightspeed account, so there’s no way for your WooCommerce store to know immediately if a product’s data has changed, or if a Lightspeed store has been deleted or a new one added, for example.

However, this plugin has implemented polling (constant checks) against Lightspeed’s API to make sure that critical values such as inventory are up to date before a customer checks out on your WooCommerce store: see the above FAQ: Sync triggers

What fields are synced? ↑ Back to top

Along with the frequent inventory checks, the following changes in Lightspeed are pulled into WooCommerce during the syncing event, or you can manually pull the changes using the “update” action:

  • SKU – this will show up under the “Custom SKU” field in Lightspeed
  • Images – live images will get overwritten during the sync from Lightspeed into WooCommerce
  • Inventory
  • Price – regular price and sale price
Note: Any sync automatically calls the Update action. This means data from Lightspeed will override the live version in your WooCommerce Store. Keep frequent database updates handy at all times. You will need them at one point.
This makes it simpler to query datasets. For example use SELECT * FROM wp_wclsi_items WHERE wc_prod_id IS NULL gives you all products in your WooCommerce store that are not linked to a Lightspeed product. 

Do sales and WooCommerce order data get synced to Lightspeed? ↑ Back to top

No, this extension sync product and inventory data only. WooCommerce order data is currently not supported. You can cast your vote for this feature here.

What’s the best way to request a feature for this plugin? ↑ Back to top

You can send us your feature request via our WooCommerce Lightspeed Ideas Board Section.  Our developer check there frequently and popular requests get turned into features from time to time, so do drop us a line. We also try to monitor and reply to as many threads as we can.

Please do keep in mind though that customisations are not supported and your idea can take a long time to implement. If you need a customisation fast, we encourage you to hire a dedicated WooExperts or Codeable developer. Visit our Customizations page for help determining if your project is better suited for Codeable or WooExperts.

What’s the best way to test this plugin? ↑ Back to top

Lightspeed allows you to test their Retail POS offering for free via a 14-day trial. We recommend to sign up for the free trial in conjunction with setting up a test WooCommerce store to see if this plugin meets your business needs.

Are there any tutorials for Lightspeed available? ↑ Back to top

Sure, apart from there documentation found at: https://retail-support.lightspeedhq.com/hc/en-us (pick Getting Started or Retail Desktop to begin) – There are also some videos on Vimeo available. They are:

What is the maximum amount of action the auto sync can perform? Can I change 1000 items at once? ↑ Back to top

The auto-sync feature can handle 100 changes every 5 seconds as a maximum workload. If you need to batch edit a lot of items, you need to break it down into steps of 100 (better make that 95 for good measure). Keep in mind that each edit count as one action. Editing a handful of variation in matrix items will therefore trigger multiple actions in the amount of your total single edits.

Is WPML supported? ↑ Back to top

WPML is not supported because of the way it manages data. Instead we recommend making use of multisite and the Multilingualpress plugin as described hereMultilingualpress sets up multi language in a modular way which is the best possible solution for your WooCommerce store.

How do I refresh the Lightspeed connection token? ↑ Back to top

WooCommerce Lightspeed uses an oAuth authentication. If you have connection problems try a complete reinstallation (deactivate, deinstall, install, activate) of the WooCommerce Lightspeed plugin. This will refresh your connection token. If this does not help, you can delete present authentication tokens in your Lightspeed account to force a new authorisation token.

Disable your WooCommerce Lightspeed plugin in your WordPress settings.

Visit your Lightspeed account and go to Settings >> Client API Access:

Click on “WooThemes” in the client column:

Scroll down to the “API Keys / Access Tokens” and click on “Revoke All”.

Activate your Lightspeed plugin and connect your Lightspeed account. This will force a new access token to be generated.

How do I fix a duplicate product ID or SKU? ↑ Back to top

WooCommerce has a couple of methods in place to make sure, all SKU’s are unique but this can fail sometimes. Especially multi language plugins may  circumvent this on purpose. An example error message will look similar to this WordPress database error: [Duplicate entry '1234' for key 'item_id']

Here is a plugin that you can try to remove duplicate SKU values from your database. As always do take a database backup before running such methods.

SKU Error Fixer for WooCommerce

I have created all my products in WooCommerce already. Can I bulk import my products from WooCommerce to Lightspeed? ↑ Back to top

Our plugin is designed with Lightspeed as the source of truth. You can only bulk send products from Lightspeed to WooCommerce not the other way around. This is also to prevent overloading the API.
What you can do is to look into importing the products via CSV. That might be faster than manually creating the items.


Are refunds in WooCommerce synced to Lightspeed ↑ Back to top

Currently there is no automatic inventory sync. After you have refunded an order in WooCommerce you need to manually restock your Lightspeed inventory.

Filter and Action Hooks ↑ Back to top

Note: This is a Developer level section. If you are unfamiliar with code, filters and hooks, and resolving potential conflicts, select a WooExpert or Developer for assistance. We are unable to provide support for customizations under our  Support Policy.

Lightspeed POS has been extended to support filters and actions that you can hook into. This allows for better customization. For example: You want the Update action to only update the inventory field and not override other fields such as title and content.

Note that this requires some technical and coding knowledge. More at WooCommerce Lightspeed Hooks.

Questions & Support ↑ Back to top

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Get in touch the developer via the Help Desk.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top