Getting started with Lightspeed POS for WooCommerce

This page covers everything you need to go from a fresh install to a working sync between Lightspeed Retail POS (X-Series) and your WooCommerce store.

---

Requirements

Requirement	Minimum version
WordPress	6.0+
WooCommerce	8.0+
PHP	7.4+
Lightspeed account	Active Lightspeed Retail POS (X-Series)

This plugin is for Lightspeed Retail POS (X-Series) only. It is not compatible with Lightspeed eCom or Lightspeed Restaurant.

---

Step 1: Download and install

Log into kestrelwp.com/my-account and go to My Subscriptions. Find your Lightspeed POS order and click Download to get the .zip file.

In your WordPress admin, go to Plugins > Add New > Upload Plugin, upload the file, and click Activate Plugin. A Lightspeed menu item appears in your WordPress sidebar when activation is complete.

---

Step 2: Enable WooCommerce stock management

Before connecting to Lightspeed, make sure WooCommerce is set up to track inventory. Go to WooCommerce > Settings > Products > Inventory and enable Enable stock management. This lets WooCommerce track stock levels and lets the plugin know when to push inventory changes back to Lightspeed after an online order.

---

Step 3: Connect to Lightspeed X-Series

1. Go to Lightspeed > Connection in your WordPress admin.
2. Select X-Series from the series dropdown.
3. Click Connect to Lightspeed X-Series.
4. You’ll be redirected to Lightspeed. Log in and authorize the connection.
5. After redirecting back to your site, the Connection page shows “Connected (not ready)”. This is expected — you still need to select an outlet register before syncing can begin.

---

Step 4: Select your outlet register

Go to Lightspeed > Settings > General and select your Outlet register from the dropdown.

The outlet register does two things:

• Determines which Lightspeed outlet’s inventory syncs to WooCommerce stock levels
• Determines which register WooCommerce sales are attributed to in Lightspeed when order sync is enabled

We recommend creating a register in Lightspeed specifically for your WooCommerce store before completing this step. If the dropdown is empty, no registers are configured in your Lightspeed account — go to your Lightspeed outlets and registers settings, create one, then reload this page.

After selecting a register and saving, the Connection page status updates to “Connected (ready)”. The plugin is now ready to sync.

Once a register is chosen and saved, it cannot be changed without disconnecting and reconnecting. Choose carefully.

---

Step 5: Test with one product before importing everything

Go to Lightspeed > Sync > Products and click Pull products from Lightspeed. This runs as a background job — it may take a few minutes depending on your catalog size.

For a faster first test, find a single product in the Sync screen, confirm it has imported into WooCommerce, and verify:

• The product appears in WooCommerce with the correct name, SKU, price, and stock level
• Adjust the product’s inventory in Lightspeed. Within your configured background polling interval, the change appears in WooCommerce.
• Place a test order in WooCommerce. When the order status reaches Processing or Completed, the stock reduces in Lightspeed.

If all three work, the sync is functioning correctly. Import the rest of your catalog.

For stores with large catalogs, take a database backup before running a full product pull. The plugin processes products in batches and handles large catalogs reliably, but a backup before the first import is good practice.

---

Go-live checklist

Before switching on for real customers:

• Connection page shows “Connected (ready)” with your outlet register selected
• All products imported and showing correctly in WooCommerce — spot-check stock levels against Lightspeed
• WooCommerce stock management is enabled (WooCommerce > Settings > Products > Inventory)
• Background sync jobs are running — go to Tools > Scheduled Actions, filter by “wclsi,” confirm jobs are Pending or Complete, not Failed
• If you have a staging site, staging mode is enabled there — go to Lightspeed > Settings > General on your staging site, confirm the staging mode toggle is on. The plugin auto-detects common staging environments, but verify this manually. Two active syncing connections to the same Lightspeed account will conflict.
• Your license key is entered under Lightspeed > Settings so your site receives automatic updates

---

Key settings to know

After setup, these are the settings you’ll interact with most:

Setting	Where to find it	What it does
Background polling intervals	Lightspeed > Settings > Background polling	Controls how often the plugin checks Lightspeed for product, customer, and image changes. Default is every 10 minutes for products. Set to staggered intervals to avoid running all jobs at once.
Order sync	Lightspeed > Settings > Orders	Disabled by default. Enable to have WooCommerce orders automatically sent to Lightspeed as sales.
Customer sync	Lightspeed > Settings > Customers	Controls whether WooCommerce customer changes push to Lightspeed automatically or on-demand only.
Product match field	Lightspeed > Settings > Products	Whether to match products by SKU or GUID. SKU is the default. Products without a value in the chosen field cannot be linked.
Category sync	Lightspeed > Settings > Products	Choose whether Lightspeed categories replace WooCommerce categories on sync, add to them, or are ignored entirely.

---

Where to go from here

Need help?

Support is included with your subscription. Open a ticket at kestrelwp.com/support. Include your plugin version (visible at Lightspeed > Settings), a description of what’s happening, and any relevant log output from WooCommerce > Status > Logs — look for files starting with wclsi.