---
title: "Get started with Lightspeed POS"
url: "https://kestrelwp.com/docs/get-started-with-lightspeed-pos/"
description: "Connect WooCommerce to Lightspeed Retail so products, prices and stock stay in sync."
published: "2026-10-07T05:32:59+00:00"
modified: "2026-10-07T05:32:59+00:00"
---

Lightspeed POS for WooCommerce connects your WooCommerce store to Lightspeed Retail, so you manage products, prices and stock once, in Lightspeed, and your online store follows. Products and stock come in from Lightspeed and stay up to date, stock is checked against Lightspeed when shoppers add to cart and check out, and you can send WooCommerce orders back to Lightspeed as sales.

One plugin supports two different Lightspeed products, **Lightspeed Retail R-Series** and **Lightspeed Retail X-Series** (formerly Vend). Their screens, settings and sync work differently, so after the shared steps on this page you follow the pages for your series only. The plugin doesn’t work with Lightspeed eCom or Lightspeed Restaurant.

## When you’d use this

- Sell in a store with Lightspeed and online with WooCommerce, from one catalog.
- Keep online stock in step with in-store sales, so you don’t oversell.
- Record online orders in Lightspeed alongside your in-store sales.
- Bring your Lightspeed catalog into a new WooCommerce store without re-entering it.

## Requirements

- WordPress 6.3 or later, WooCommerce 9.9 or later, and PHP 7.4 or later with the OpenSSL extension (needed to set up the plugin and for X-Series), which it uses to store your Lightspeed credentials.
- WP-Cron and loopback requests working on your site. Syncing runs in the background through WooCommerce’s Action Scheduler, and the plugin shows a notice if either is unavailable.
- Compatible with WooCommerce’s cart and checkout blocks and High-Performance Order Storage.
- WooCommerce stock management turned on (**WooCommerce » Settings » Products » Inventory » Enable stock management**).
- An active Lightspeed Retail account: 
    - **X-Series** needs Lightspeed API access. On Lightspeed’s current plans, that comes with the Plus plan; some older plans include it.
    - **R-Series** needs a Lightspeed employee login with inventory privileges to authorize the connection.

## Install and activate

How you install and get updates depends on where you bought the plugin:

- **Bought on kestrelwp.com:** download the plugin from your kestrelwp.com account and install it. Then go to **Settings » Lightspeed POS for WooCommerce activation**, enter your **License key** and activate it to receive updates. See [using sites against your activation limit](/docs/using-sites-against-your-activation-limit/) for how activations count.
- **Bought on WooCommerce.com:** install the plugin from your WooCommerce.com account. Updates come through your WooCommerce.com connection, with no license key to enter.

For upload, FTP and update steps, follow [how to install and update WooCommerce extensions](/docs/install-update-woocommerce-extensions/). Once the plugin is active, a **Lightspeed** menu appears in your WordPress admin.

## Set up Lightspeed POS

### 1. Find out which series you have

Log in to Lightspeed. Your account shows either **Retail (R-Series)** or **Retail POS (X-Series)**. You pick the series once when you connect, and changing it later means disconnecting, so check first.

### 2. Turn on stock management

Go to **WooCommerce » Settings » Products » Inventory**, turn on **Enable stock management** and save. Stock only syncs for products that manage stock.

### 3. Connect to Lightspeed

Go to **Lightspeed » Connection**, choose your series under **Retail POS series**, and click **Connect to Lightspeed X-Series** or **Connect to Lightspeed R-Series**. Lightspeed asks you to log in and approve the connection, then sends you back to this screen.

![Lightspeed Pos: Connect to Lightspeed (page title, the series select, Status row and the Connect button)](https://kestrelwp.com/wp-content/uploads/2026/10/lightspeed-pos-ls-02.png)### 4. Finish setup for your series

The rest of the setup is different for each series:

- **X-Series:** choose an outlet register, import your products and check the sync. Follow [Set up Lightspeed X-Series](/docs/set-up-lightspeed-x-series/).
- **R-Series:** choose your inventory store, load and import your products, and check the sync. Follow [Set up Lightspeed R-Series](/docs/set-up-lightspeed-r-series/).

Each setup page ends with a test you can see: change a product’s stock in Lightspeed and watch it update in WooCommerce.

## How syncing works

Lightspeed is the source of truth for your catalog and stock. The plugin brings Lightspeed changes into WooCommerce on a schedule you set, and a stock value you type in WooCommerce is overwritten by the next update from Lightspeed. Manage stock in Lightspeed, and avoid other plugins that write stock to synced products.

Three things keep online stock accurate between scheduled updates:

- When a shopper adds a synced product to the cart, the plugin asks Lightspeed for its current stock first, and WooCommerce blocks the add if it’s out of stock.
- On the classic checkout, the plugin checks the cart against Lightspeed again before the order is placed. The checkout block relies on the add to cart check and the scheduled updates.
- When a WooCommerce order reduces stock, the new stock goes back to Lightspeed.

Orders only go one way. WooCommerce orders can be sent to Lightspeed as sales, but sales made in Lightspeed are never brought into WooCommerce. Order sync is off until you turn it on.

## The Lightspeed menu

What you see under **Lightspeed** depends on your series:

| Screen | X-Series | R-Series |
|---|---|---|
| **Connection** | Connect, reconnect or disconnect | Connect, reconnect or disconnect |
| **Settings** | [Lightspeed X-Series settings](/docs/lightspeed-x-series-settings/) | [Lightspeed R-Series settings](/docs/lightspeed-r-series-settings/) |
| **Sync** | Import and export products and customers, and see activity | Not shown |
| **Product Importer** | Not shown | Load Lightspeed products and import them |

## Common issues

### The settings for my series are missing

Only the series you connected shows its screens. Check **Lightspeed » Connection**: if the wrong series is selected, click **Disconnect**, choose the right one under **Retail POS series**, and connect again. **Retail POS series** can’t be changed while you’re connected ("To change this setting, please disconnect first.").

### "The OpenSSL PHP extension is not available on this site."

The plugin needs OpenSSL to finish setup and for X-Series. Ask your host to enable the OpenSSL extension for PHP.

### "WP Cron appears to be disabled on this site."

Background syncing relies on WP-Cron. Remove `DISABLE_WP_CRON` from `wp-config.php`, or keep it and have your host run a real cron job that calls `wp-cron.php` every minute or so. If you already have that cron job, you can dismiss the notice.

### "Loopback requests are not supported on this site."

Imports and exports run as background requests your site sends to itself. Ask your host to allow loopback requests, or check whether a security plugin or firewall is blocking them.

### "This plugin requires WooCommerce version 9.9 or higher."

Update WooCommerce. The plugin doesn’t load on older versions.

### I need help with something else

Each series has its own troubleshooting page: [Troubleshoot Lightspeed X-Series](/docs/troubleshoot-lightspeed-x-series/) and [Troubleshoot Lightspeed R-Series](/docs/troubleshoot-lightspeed-r-series/). When you contact support, include your plugin version (shown on **Plugins**), your series, and what you see in the logs under **WooCommerce » Status » Logs**.

## Keep learning

- [Set up Lightspeed X-Series](/docs/set-up-lightspeed-x-series/)
- [Set up Lightspeed R-Series](/docs/set-up-lightspeed-r-series/)
- [How to install and update WooCommerce extensions](/docs/install-update-woocommerce-extensions/)
- [Lightspeed POS developer reference](/docs/lightspeed-pos-developer-reference/) (hooks and code snippets)
