WooCommerce Lightspeed POS connects your Lightspeed Retail point-of-sale system with your WooCommerce store. When a sale happens in-store, stock adjusts in WooCommerce. When an online order comes in, it reduces inventory in Lightspeed. You manage products once, in Lightspeed, and your online store reflects it.
This integration supports both Lightspeed Retail R-Series and Lightspeed Retail X-Series.
Note: This integration works with Lightspeed Retail only. It is not compatible with Lightspeed eCom or Lightspeed Restaurant.
Which Lightspeed platform are you using?
↑ Back to topLog into your Lightspeed dashboard — it will show either “Retail (R-Series)” or “Retail POS (X-Series)” in the interface. The setup and sync workflow differ between the two, so follow the guide for your platform:
Installation
↑ Back to top- Download the
.zipfile from your WooCommerce.com account. - Go to WordPress Admin > Plugins > Add New and upload the file.
- Activate the plugin.
- Navigate to Lightspeed > Connection to begin setup.
Requirements
↑ Back to top| Requirement | Minimum version |
|---|---|
| WordPress | 6.0+ |
| WooCommerce | 8.0+ |
| PHP | 7.4+ |
| Lightspeed account | Active Lightspeed Retail R-Series or X-Series |
Connect your site to WooCommerce.com
↑ Back to topBefore connecting to Lightspeed, connect your site to WooCommerce.com so you receive plugin updates automatically. Go to WooCommerce > My Subscriptions and follow the prompts to link your site.
Updates include bug fixes and compatibility improvements.
Logs
↑ Back to topThe plugin writes log files under WooCommerce > Status > Logs:
| Log file | What it captures |
|---|---|
wclsi-errors.log | Exceptions and errors — start here when something isn’t working |
wclsi-sync-events.log | General sync activity between the two platforms |
wclsi-debugger.log | Detailed debug data (only generated when debug mode is enabled in Settings > General) |
Troubleshooting and support
↑ Back to topCannot connect to Lightspeed
↑ Back to top- Confirm your Lightspeed account is active.
- Verify you’re connecting to the correct platform — R-Series or X-Series. Your Lightspeed dashboard shows this clearly.
- Clear your browser cache or try a private/incognito window during the OAuth flow.
- Check whether a security plugin is blocking the OAuth redirect.
For platform-specific connection issues, see your series documentation.
Products are not syncing from Lightspeed
↑ Back to top- Go to Tools > Scheduled Actions and filter by Pending or Failed. Look for stuck or backed-up Lightspeed jobs.
- Verify WP-Cron is running. If
DISABLE_WP_CRONis set inwp-config.php, configure an external cron job to hitwp-cron.phpregularly. - Check
wclsi-errors.logfor API errors.
If another plugin using Action Scheduler is blocking jobs, you’ll see: “Maximum simultaneous queues already in progress.” Disable the conflicting plugin, cancel the stuck job, and contact that plugin’s author.
For platform-specific sync issues, see your series documentation.
Getting 429 “Rate Limit Exceeded” errors
↑ Back to topLightspeed uses a leaky bucket algorithm and rejects requests coming in faster than roughly 1 per second. Common causes:
- Triggering manual sync too frequently
- Syncing variable products with many variations and large images (image uploads are API-intensive)
For platform-specific rate limit handling, see your series documentation.
Images are missing after import
↑ Back to topWordPress can time out processing large images. Images under 2MB and under 2000×2000px are generally safe. Resize large images in Lightspeed before importing.
A sync update failed with a warning notice
↑ Back to top“A sync update for Lightspeed Product ‘…’ has failed” — a WooCommerce-to-Lightspeed sync did not complete. Common after bulk updating products in the Products page, which fires many API calls simultaneously and can trigger rate limiting. Manually save the affected product to queue a fresh sync attempt.
Fatal error: ActionScheduler args too long
↑ Back to topAction Scheduler accepts arguments up to 8,000 characters as JSON. If a product has a very long description, the serialized data may exceed this limit. Keep product descriptions within a reasonable character length.
FAQ
↑ Back to topDoes this work with Lightspeed R-Series and X-Series?
↑ Back to topYes. Both are supported by the same plugin. R-Series has been supported since the original release. X-Series support was added in v3.0.0. The setup and workflow differ between the two — see the separate documentation for each.
Does it work with Lightspeed eCom?
↑ Back to topNo. This integration is for Lightspeed Retail (R-Series and X-Series) only. Lightspeed eCom is a separate product and is not compatible.
Do WooCommerce orders sync to Lightspeed?
↑ Back to topYes. Order sync is supported on both platforms. See your series documentation for setup details.
Do refunds sync?
↑ Back to topYes. After a refund and restock, the plugin updates inventory in Lightspeed on both series.
Are backorders supported?
↑ Back to topNo. WooCommerce backorders are not supported.
Can I sync products from multiple Lightspeed stores?
↑ Back to topYou can import products from multiple locations, but inventory sync runs against one store only. See your series documentation for how to configure which store is used.
My product count is different in Lightspeed and WooCommerce — is that normal?
↑ Back to topYes. Lightspeed counts each Matrix variation as a separate item. WooCommerce groups them under a single variable product. Product counts will not match if you use Matrix products.
Can I duplicate products using a plugin?
↑ Back to topNo. Product duplication is not supported. Import or create products fresh from Lightspeed.
What happens when I archive a product in Lightspeed?
↑ Back to topThe product’s inventory is set to 0 in WooCommerce. The sync link remains active.
How do I request a feature?
↑ Back to topSubmit requests on the WooCommerce Lightspeed Ideas Board. Popular requests get prioritized for development.
Where can I get support?
↑ Back to topOpen a support conversation via the Kestrel support team.
