WooCommerce Point of Sale - Installation & Setup Guide

Prerequisites

Essential Requirements

Before installation, ensure you have:

RequirementSpecification
WordPressVersion 5.0 or higher
WooCommerceVersion 4.0 or higher
PHPVersion 7.4 or higher (8.0+ recommended)
MySQL5.6+ or MariaDB 10.1+
Memory LimitMinimum 256MB (512MB recommended)
WooCommerce SetupProducts, payment gateways, and shipping configured
User PermissionsAdministrator access to WordPress

Server Requirements

  • SSL Certificate: Recommended for secure transactions
  • Cron Job Access: For scheduled synchronization
  • Node.js: Version 14+ (for full WhatsApp/Node features)
  • File Permissions: Write access to WordPress directories
  • API Access: REST API must be enabled

What You'll Need

  • Purchase Code from Webkul
  • WooCommerce Store with products
  • Admin Credentials for WordPress
  • Barcode Scanner (optional but recommended)
  • Thermal Printer (optional for receipts)

Step-by-Step Installation

Step 1: Access Plugin Installation

  1. Log in to your WordPress Admin Panel
  2. Navigate to: Plugins → Add New
  3. Click "Upload Plugin" button at top

installation-add-new

Step 2: Upload the Plugin

  1. Click "Choose File" button
  2. Select the downloaded woo-point-of-sale.zip file
  3. Click "Install Now"

installation-upload-pluginStep 3: Activate the Plugin

  1. After successful installation, click "Activate Plugin"
  2. Wait for activation confirmation message

installation-activate-plugin

Check how to activate your WooCommerce plugin through the purchase code.

Method 2: FTP Installation (Alternative)

Step 1: Prepare Files

  1. Unzip the downloaded package
  2. Extract the woo-point-of-sale folder

Step 2: Upload via FTP

  1. Connect to your server via FTP/SFTP
  2. Navigate to: /wp-content/plugins/
  3. Upload the woo-point-of-sale folder

Step 3: Activate

  1. Go to WordPress Admin → Plugins
  2. Find "WooCommerce Point of Sale"
  3. Click "Activate"

Post-Installation Checks

  • Clear WordPress cache if using caching plugins
  • Check for PHP errors in debug log
  • Verify plugin appears in installed plugins list
  • Ensure no conflicts with other plugins

Initial Configuration

The POS Wizard

After activating the plugin, under General Settings, the admin will find the Help icon in the top-right menu bar. Once the admin clicks on it, a menu will open as shown in the image below.

woocommece-pos-help

Setup Wizard

When the admin clicks on the Setup Wizard tab, it redirects to the Wizard Configurations page, as shown in the image below.

Initially, the admin will see the Begin Wizard menu option. To start configuring the POS, the admin needs to click on Let’s go!.

woocommece-pos-help

General Settings Configuration

Clicking on Let’s go! navigates the admin to the General Settings page, as shown in the image below. For more details, you can refer to our User Guide and Video Tutorial.

Under General Settings, the admin needs to configure the following:

  • API Username
  • API Password
  • Inventory Type
  • Default Product Status
  • Enable Unit Price Feature
  • Enable Emails at POS End

After filling in the details, click on Next! to proceed to the next step.

woocommece-pos-helpwoocommece-pos-help

Web App Settings

Next, the admin needs to configure the Web App Settings, where the following details are added:

  • App Name
  • Short Name
  • Theme Color
  • Background Color

Additionally, the Default Customer Configuration details will be auto-filled, as shown in the image below.

woocommece-pos-help

Wizard Completion

Finally, the admin is redirected to the Ready menu option. From here, the admin can:

  • Create an Outlet
  • Import Outlets

Once these steps are completed, the POS Wizard setup is finished.

POS_setup_wizard_img5

License Activation

Activation Process

Step 1: Locate Purchase Code

  • Find purchase code in your Webkul purchase email
  • Or access from Webkul client area

pos-license

Step 2: Enter License Details

  1. Navigate to: Point of Sale → Settings → License
  2. Enter Purchase Code
  3. Enter Registered Email
  4. Click "Activate License"

Step 3: Verify Activation

  • Green checkmark indicates successful activation
  • License details will display expiration date
  • Activation status shows in plugin header

License Management

  • View License: Check status and expiration
  • Renew License: Before expiration for updates
  • Transfer License: Move to another domain
  • Deactivate: Free up license for reuse

Essential Settings to Configure:

1. Permalink Flush

  1. Go to: Settings → Permalinks
  2. Click "Save Changes" (no changes needed)
  3. This ensures POS endpoints work correctly

permalink

2. General Configuration

generalconfig

Configure basic connection, branding, and invoice assets for the Point of Sale system.

Configuration SettingDefault / Sample ValueDescription
App Connection Password2eBbo%1TFb9CUsed to authenticate the API connection between the WooCommerce store and the POS mobile app.
Generate New PasswordAction ButtonGenerates a new password for the API connection (recommended to clear/change periodically).
POS Heading LoginWooCommerce POS SystemDefines the heading text displayed on the front-end POS login screen.
Brand Name for FooterWebkulSpecifies the brand name displayed in the footer area of the POS cashier panel.
Brand Link for Footerhttps://webkul.com/Sets the clickable URL linked to the brand name in the footer section.
Invoice LogoFile UploadAllows uploading a custom logo image to display on printed and digital receipts/invoices.

3. POS Panel Configurations

pos-panel-config

Configure operational logic, cashier capabilities, and interface defaults for the POS grid.

Configuration SettingDefault StateDescription
Select Inventory TypeCentralized Stock InventoryDefines if the POS utilizes unified centralized stock levels or separate local inventories.
Default Product StatusEnabledSets whether products assigned to an outlet are immediately active or inactive.
Enable Zero Price ProductsEnabledAllows selling products with a price of $0.00 in the POS interface.
Enable Unit Price FeatureEnabledEnables displaying and calculating pricing based on unit quantities (e.g. weight, volume).
Opening Amount Drawer StatusEnabledPrompts cashiers to enter the starting cash drawer balance at the beginning of their shift.
POS Invoice OptionEnabledEnables the automatic creation and print-readiness of customer invoices/receipts.
Enable Mails at POS EndEnabledSends order confirmation and invoice emails automatically upon transaction completion.
Enable Keyboard ShortcutsEnabledActivates key bindings (shortcuts) for rapid checkout operations.
Enable POS Logo to HeaderEnabledDisplays the custom store/POS logo in the main header of the cashier panel.
Order Status Change PermissionEnabledAuthorizes POS cashiers to change the status of orders directly from the POS interface.

POS Cron Configurations

Here, the admin can configure and manage POS cron jobs and Node server settings.

POS Cron Settings

The admin can:

  • Set the Cron Type Choose between WP Cron or Server Cron.

  • Enable / Disable Auto Drawer Close Turn automatic drawer closing on or off.

  • Set Drawer Time Define the time after which the drawer will close automatically.

  • Run Cron Commands Execute cron commands from the root directory.

Server Cron Setup

For Server Cron

wget -q -O - https://wpdemo.webkul.com/woocommerce-point-of-sale-115-113-191-18/wp-content/plugins/woo-point-of-sale/wcpos-cron.php >/dev/null 2>&1