# Install WCPOS

WCPOS is a plugin for your WooCommerce site. Install it once and the POS is ready in a browser at `yourdomain.com/pos`. The desktop and mobile apps are optional: they open the same POS and sign in to the same site.

Installing is a job for whoever looks after the website. Cashiers can start at [Open the POS](#accessing-the-pos).

## Check your site is ready[​](#server-requirements "Direct link to Check your site is ready")

* **WooCommerce 9.0** or later, installed and active. Check under **Plugins** in WP Admin.
* **WordPress 5.6** or later, or 5.8 with Pro. Check on the **Dashboard** in WP Admin.
* **PHP 7.4** or later. Check in your hosting account, or ask your host.
* **Permalinks** set to anything except **Plain**. Check under **Settings › Permalinks** in WP Admin.

WCPOS 2.0 needs WooCommerce 9.0; 1.x ran on older versions. If your store is on WCPOS 1.x today, read [Upgrading to 2.0](/getting-started/upgrading-to-2.md) before you update anything.

For a busy store, the server matters as much as these minimums. See [Server performance](/support/performance/server.md#minimum-server-requirements).

## Install the plugin[​](#installing-the-plugin "Direct link to Install the plugin")

1. In WP Admin, go to **Plugins** and add a new plugin.
2. Search for **WCPOS**. In the results the plugin is **WCPOS – Point of Sale (POS) plugin for WooCommerce**, by kilbot.
3. Press **Install Now**, then **Activate**.

WordPress installs the current release from the WordPress.org plugin directory. This page describes WCPOS 2.0 or later: once the plugin is active, [Check what's installed](#check-versions) shows its version under **Server**. If the **Plugins** page shows the plugin at version 1.11 or earlier, you have WCPOS 1.x: follow the [1.x installation guide](/1.x/getting-started/installation) instead.

WP Admin now has a **POS** menu. **View POS** opens the POS, **Settings** holds the plugin's settings, and **Templates** holds the receipt templates. On the free plugin the menu also has **Upgrade to Pro**.

Here it is on a store with the free plugin, open on **Settings**, then the menu close up:

![WP Admin with the POS menu open on Settings, and the plugin's Checkout settings on the right](/img/2.x/getting-started/installation/en/desktop-light-regular--i1-5-wp-admin-pos-menu.png)1

1. **POS** — the plugin's menu in WP Admin.

![The POS menu in WP Admin close up: Upgrade to Pro, Settings, Templates and View POS](/img/2.x/getting-started/installation/en/desktop-light-regular--i1-6-pos-menu.png)1234

1. **Upgrade to Pro** — on the free plugin only.
2. **Settings** — the plugin's settings.
3. **Templates** — the receipt templates.
4. **View POS** — opens the POS.

You can also download the plugin from [WordPress.org](https://wordpress.org/plugins/woocommerce-pos/) and add it with **Upload Plugin** on the same screen.

With WCPOS Pro

Pro is its own plugin and contains everything in the free one: install **WCPOS Pro** and activate your licence. If the free plugin is installed too, Pro switches it off. See [With WCPOS Pro](#with-pro) below and [Installing WCPOS Pro](/getting-started/pro-license.md#installation).

## Open the POS[​](#accessing-the-pos "Direct link to Open the POS")

1. In a browser, go to `yourdomain.com/pos`, or choose **POS › View POS** in WP Admin.
2. Sign in with your WordPress username and password.
3. If the store has several registers, the POS asks **Which register is this device at?** the first time. Pick the one you're at. See [Stores, Registers and Devices](/stores/registers-and-devices.md).
4. If the cart shows an **Open register** card, enter the cash in the drawer and press **Open register**. It shows only with **Open and close the register** turned on, while the register is closed. See [Registers](/settings/wp-admin/registers.md).

Ready to serve a customer? Follow [Checkout](/pos/checkout.md) to make your first sale. Here is the POS open, with a search typed in and the **In Stock** filter on. Clear both to see the rest of your products, or see [Search & Filtering](/pos/product-panel/search-filtering.md#no-match) if one is missing:

![The POS open in a browser: the menu down the left with POS selected and Health, Settings and Support at its foot, the product search, the store name and the cashier's avatar above the cart](/img/2.x/getting-started/installation/en/tablet-light-regular--i1-1-pos-first-open.png)1234567

1. **POS** — opens the register screen: products on the left, the cart on the right. On a phone, they're on separate tabs. See [Checkout](/pos/checkout.md).
2. **Register bar** — the store you're selling for, and the register when the store has more than one. See [Stores, Registers and Devices](/stores/registers-and-devices.md).
3. **Your avatar** — your cashier sheet: the drawer, handing over and signing out. In a browser it also holds the **Desktop App** link. See [Your cashier sheet](/pos/register.md#cashier-sheet).
4. **Search products** — find a product by name, SKU or barcode. See [Products](/pos/product-panel.md).
5. **Health** — whether this device and your store are talking properly, and what to do if not. See [Store Health](/support/store-health.md).
6. **Settings** — language, printing, card readers, barcode scanning, theme and more. See [Settings](/settings.md).
7. **Support** — the WCPOS community on Discord, inside the POS. See [Support](/support.md).

The first time you open it, the POS copies your products onto the device so it can keep selling through a dropped connection. See [Offline](/getting-started/offline.md).

Administrators and shop managers can use the POS straight away. For everyone else, the plugin adds a **Cashier** role: give it to the people who sell. See [Access](/settings/wp-admin/access.md).

### Do you need to be signed in to WordPress?[​](#sign-in "Direct link to Do you need to be signed in to WordPress?")

Yes. The POS uses your WordPress account: there's no separate POS login. If this browser isn't signed in to WordPress, `/pos` opens the WordPress sign-in page, and the POS opens once you've signed in.

Signed in, but the page reads **This account cannot use the POS**? Your WordPress role isn't allowed to use it. See [Access](/settings/wp-admin/access.md#goes-wrong).

Page not found at `/pos`? See [`/pos` shows page not found](#pos-not-found).

## Get the desktop and mobile apps[​](#app-requirements "Direct link to Get the desktop and mobile apps")

The browser needs nothing else. Use a current version of Chrome, Edge, Firefox or Safari, with JavaScript on, in a normal window: a private window can clear the POS's data on the device mid-session, and deletes it when it closes.

The apps run the same POS in their own window. Download the one for your device:

* **Windows** — Windows 10 or later, 64-bit (x64). Download the [Windows installer](https://updates.wcpos.com/v1/electron/download/win32-x64).
* **macOS** — macOS 12 Monterey or later. Download for [Apple silicon](https://updates.wcpos.com/v1/electron/download/darwin-arm64) or [Intel](https://updates.wcpos.com/v1/electron/download/darwin-x64).
* **Linux** — 64-bit (x64). Download the [.deb for Debian and Ubuntu](https://updates.wcpos.com/v1/electron/download/linux-x64) or the [.rpm for Fedora and Red Hat](https://updates.wcpos.com/v1/electron/download/linux-x64-rpm).
* **iPhone and iPad** — iOS and iPadOS 16.4 or later. Join the [TestFlight beta](https://testflight.apple.com/join/JGBdVRrW).
* **Android** — Android 10 or later. Join the [Google Play beta](https://play.google.com/apps/testing/com.wcpos.main).

Open the app and add your store on its **Connect** screen. See [Connect to Your Store](/getting-started/connect.md).

In the POS in a browser, the **Desktop App** link in your cashier sheet opens the desktop app's download page too.

![The foot of the cashier sheet in a browser: the WordPress Admin and Desktop App links, then Sign out and Close](/img/2.x/getting-started/installation/en/tablet-light-regular--i1-3-cashier-sheet-desktop-app.png)123

1. **WordPress Admin** — opens WP Admin on your site.
2. **Desktop App** — the desktop app's download page.
3. **Sign out** — in a browser, this signs you out of WordPress too.

Printing from the apps

Bluetooth and network printers need the app's Bluetooth and local network permissions. Allow them when the app asks. See [Android permissions](/hardware/printers/android-permissions.md) and [iOS local network](/hardware/printers/ios-local-network.md).

## Check what's installed[​](#check-versions "Direct link to Check what's installed")

Tap the version number at the foot of the menu down the left, such as **v 2.0.0**, to open **About WCPOS**. On a phone it reads **Version 2.0.0**, in the menu that the **Menu** button opens.

**With Pro**

![About WCPOS on a Pro store: App Version and Platform under Application, WCPOS Pro Plugin, WooCommerce and WordPress versions under Server, License Status Pro, and the Release Notes button](/img/2.x/getting-started/installation/en/tablet-light-regular--i1-2-about-pro.png)1234

1. **Application** — the version of the POS on this device, and where it runs: **Web**, **Desktop**, **iOS** or **Android**.
2. **Server** — the **WCPOS Plugin** version, or **WCPOS Pro Plugin** with Pro, then the WooCommerce and WordPress versions on your site.
3. **License** — **Status** reads **Pro** or **Free**.
4. **Release Notes** — opens the current WCPOS versions and what changed in them.

**Free**

![About WCPOS on a free store: App Version and Platform Web, WCPOS Plugin, WooCommerce and WordPress versions, and License Status Free](/img/2.x/getting-started/installation/en/tablet-light-regular--i1-4-about-free.png)

The app needs WCPOS plugin 2.0.0 or later: that is the version under **Server**. If the plugin is older than that, or newer than this app can work with, the POS says which one to update. See [If something goes wrong](#troubleshooting).

## With WCPOS Pro[​](#with-pro "Direct link to With WCPOS Pro")

### Which download is Pro?[​](#which-download "Direct link to Which download is Pro?")

Once installed, the two plugins have these names on your **Plugins** page (the WordPress.org listing above uses a longer name for the free one):

* **WCPOS – Point of Sale for WooCommerce** is the free plugin, from WordPress.org.
* **WCPOS Pro – Point of Sale for WooCommerce** is Pro. It comes only from the [Downloads](https://wcpos.com/account/downloads) page of your wcpos.com account, as a zip file.

### Install Pro over the free plugin without losing data[​](#pro-over-free "Direct link to Install Pro over the free plugin without losing data")

Install Pro with the free plugin still in place: you don't remove anything first. When Pro starts, it switches the free plugin off and shows a notice saying so.

Your data stays. Pro has the free plugin's code inside it, so it uses the POS settings, receipt templates and registers already on your site. Switching the free plugin off doesn't delete them, and your orders, products and customers belong to WooCommerce: neither plugin removes them.

Then activate your licence key: see [Activate your licence key](/getting-started/pro-license.md#activate).

## If something goes wrong[​](#troubleshooting "Direct link to If something goes wrong")

**"WCPOS requires WooCommerce 9.0 or higher"** at the top of WP Admin. WooCommerce is missing, switched off or older than 9.0. Install or update it, then activate it. On a store still running WCPOS 1.x, follow [Upgrading to 2.0](/getting-started/upgrading-to-2.md#if-your-store-isnt-ready-yet).

**"WCPOS requires PHP 7.4 or higher"**. Ask your host to move the site to a newer PHP version.

**"WooCommerce REST API requires pretty permalinks to work correctly"**, or `yourdomain.com/pos` shows your site's page-not-found. See [`/pos` shows page not found](#pos-not-found).

**"Update the WCPOS plugin on your WordPress site."** The app is newer than the plugin. Update WCPOS in **Plugins**. See [AUTH331](/error-codes/AUTH331.md).

**"Update the POS app on this device."** The plugin is newer than the app. In a browser, reload the page. In an app, install its update. See [SYNC341](/error-codes/SYNC341.md).

**The sign-in window shows an error or a blank page.** A security, firewall or login plugin is usually in the way. See [Plugin Conflicts](/support/troubleshooting/plugin-conflicts.md#security-and-login-plugins).

**"This account cannot use the POS"** after you sign in. Your WordPress role isn't allowed to use the POS. See [Access](/settings/wp-admin/access.md#goes-wrong).

**Still stuck?** Ask on [Discord](https://wcpos.com/discord). For licence or private questions, email <support@wcpos.com>. See [Support](/support.md).

### `/pos` shows page not found[​](#pos-not-found "Direct link to pos-not-found")

Your site's page-not-found at `yourdomain.com/pos`, signed in or not, has two usual causes:

* **Permalinks are set to Plain.** The POS address needs any other setting. WP Admin shows **"WooCommerce REST API requires pretty permalinks to work correctly"**: press **Enable permalinks** on the notice, or open **Settings › Permalinks**, choose any other setting and press **Save Changes**.
* **The POS has another address.** An administrator can change `pos` to something else: look for **POS base** in **Settings › Permalinks**. See [Open the POS in a browser](/getting-started/connect.md#web).

## Related Documentation[​](#related-documentation "Direct link to Related Documentation")

[Connect to Your StoreAdd your store to the app and sign in.](/getting-started/connect.md)

[Installing WCPOS ProDownload Pro and activate your licence.](/getting-started/pro-license.md)

[Upgrading to 2.0Moving a store from WCPOS 1.x.](/getting-started/upgrading-to-2.md)
