# POS Only Products

POS Only Products is a feature that lets you control whether products appear in your online store, your POS, or both. This is useful when you have different product catalogues for online and in-store sales.

## Overview[​](#overview "Direct link to Overview")

When enabled, each product gets a **POS Visibility** setting with three options:

| Visibility                 | Online Store | POS     |
| -------------------------- | ------------ | ------- |
| **POS & Online** (default) | Visible      | Visible |
| **POS Only**               | Hidden       | Visible |
| **Online Only**            | Visible      | Hidden  |

## When to Use This Feature[​](#when-to-use-this-feature "Direct link to When to Use This Feature")

Enable POS Only Products if you need to:

* **Sell in-store exclusives** - Products only available when customers visit your physical store
* **Hide online-only items from POS** - Digital products, pre-orders, or items that shouldn't be sold in-store
* **Manage different catalogues** - Separate product ranges for online and retail channels
* **Control promotional items** - In-store-only specials or online-exclusive deals

tip

If all your products should appear in both channels, you don't need this feature. Leave it disabled for better performance.

## Enabling the Feature[​](#enabling-the-feature "Direct link to Enabling the Feature")

1. Go to **WP Admin > POS > Settings > General**
2. Enable **"Enable POS Only Products"**
3. Save changes

For more details on General Settings, see [WP Admin General Settings](/settings/wp-admin/general.md).

Performance Impact

Only enable this setting if you need it. When enabled, it adds an extra database lookup for every product request, which can impact performance on stores with large catalogues.

## Setting Product Visibility[​](#setting-product-visibility "Direct link to Setting Product Visibility")

### Individual Products[​](#individual-products "Direct link to Individual Products")

To set visibility for a single product:

1. Go to **WP Admin → Products** and edit a product

2. In the **Product data** panel, look for **POS Visibility**

3. Select your desired option:

   <!-- -->

   * **POS & Online** - Product appears everywhere (default)
   * **POS Only** - Product hidden from online store
   * **Online Only** - Product hidden from POS

4. Click **Update** to save

![POS Visibility setting in the product data panel](/img/pos-only-products.png)

POS Visibility setting in the Product data panel

### Bulk Editing[​](#bulk-editing "Direct link to Bulk Editing")

To change visibility for multiple products at once:

1. Go to **WP Admin → Products**
2. Select the products you want to modify using the checkboxes
3. From the **Bulk actions** dropdown, select **Edit**
4. Click **Apply**
5. In the bulk edit panel, find the **POS Visibility** dropdown
6. Select your desired visibility option
7. Click **Update**

![Bulk editing POS visibility for multiple products](/img/bulk-edit-pos-only-products.png)

Bulk editing POS visibility from the Products list

### Variable Products[​](#variable-products "Direct link to Variable Products")

For variable products, you can set visibility at both the parent product level and for each individual variation. This gives you fine-grained control - for example, you could show all variations online but only certain colours or sizes in-store.

![POS Visibility settings for individual variations](/img/pos-only-variations.png)

Each variation has its own POS Visibility setting

## How It Affects the POS[​](#how-it-affects-the-pos "Direct link to How It Affects the POS")

When a product is set to **Online Only**:

* It won't appear in the [Product Panel](/pos/product-panel.md)
* It won't be found via search or barcode scanning
* It cannot be added to cart in the POS

When a product is set to **POS Only**:

* WCPOS sets its WooCommerce **Catalog visibility** to **Hidden** for you, so it is left out of the shop, category pages, search, related products, product blocks, feeds, sitemaps and anything else that honours WooCommerce's catalog visibility, including search plugins
* It cannot be added to the cart or bought online
* It is kept out of the WooCommerce REST API and Store API product lists

While a product is POS Only, the **Catalog visibility** control in the Publish box is locked at **Hidden**. When you move the product back to **POS & Online** or **Online Only**, WCPOS restores the catalog visibility it had before it became POS Only. A product that was never anything but visible goes back to **Shop and search results**. If you want a different catalog visibility after the move, set it as a second edit.

Variations have no catalog visibility of their own in WooCommerce. A POS Only variation is left out of the options offered on the product page, and the parent product stays online for its other variations. Set the parent product itself to POS Only when the whole product is in-store only.

note

If you've recently changed a product's visibility and it's still appearing (or not appearing) in the POS, try a sync. Long press the sync button and select **"Clear and Refresh"** to reload all product data.

### Where POS Only products stay visible[​](#where-pos-only-products-stay-visible "Direct link to Where POS Only products stay visible")

Hiding a POS Only product is a storefront rule. The product stays visible wherever you are running the shop rather than shopping in it:

* **WP Admin**, including the Products list and the product editor
* **WooCommerce Analytics**, so a report filtered by a category of POS Only products shows their sales
* **WP-CLI** commands such as `wp wc product list`
* **The POS itself**

It is hidden from the shop catalogue and search, from the WooCommerce Store API used by the block cart and checkout, from the WooCommerce REST API (`/wc/v3/products`), and from anything built on those, such as product feeds and sitemaps.

Developers can change the decision for a context of their own with the `wcpos_hide_pos_only_products` filter. It receives the default decision and the `WP_Query` about to run; return `false` to let that query see POS Only products. Before WCPOS 2.0 this filter and the catalog visibility filter below were named `woocommerce_pos_hide_pos_only_products` and `woocommerce_pos_pos_only_catalog_visibility`; those names still work but are deprecated since 2.0 and are removed in 2.2 at the earliest (see [Hook naming](/extensions.md#hook-naming)).

```
add_filter( 'wcpos_hide_pos_only_products', function ( $hide, $query ) {

    if ( defined( 'MY_PLUGIN_EXPORTING' ) ) {

        return false;

    }

    return $hide;

}, 10, 2 );
```

The catalog visibility WCPOS writes for a POS Only product goes through the `wcpos_pos_only_catalog_visibility` filter. It receives the value about to be applied, `hidden`, and the product. Return one of WooCommerce's catalog visibility keys (`visible`, `catalog`, `search` or `hidden`) to apply that value instead, or `null` to leave the product's catalog visibility alone so you can manage it yourself. This filter only controls what WCPOS writes into WooCommerce's Catalog visibility; WCPOS's own storefront rule above still applies, so pair it with `wcpos_hide_pos_only_products` if you want a POS Only product to actually appear somewhere online.

```
add_filter( 'wcpos_pos_only_catalog_visibility', function ( $visibility, $product ) {

    if ( has_term( 'club-stock', 'product_cat', $product->get_id() ) ) {

        return null; // I manage catalog visibility for these myself.

    }

    return $visibility;

}, 10, 2 );
```

## Common Use Cases[​](#common-use-cases "Direct link to Common Use Cases")

#### In-Store Only Gift Cards

Physical gift cards that need to be activated at the register:

1. Create the gift card product
2. Set visibility to **POS Only**
3. The card won't appear online but staff can sell it in-store

#### Online Pre-Orders

Products available for pre-order online but not yet in stock:

1. Create the pre-order product
2. Set visibility to **Online Only**
3. Customers can pre-order online, but it won't clutter the POS

#### Wholesale vs Retail

If you use the same WooCommerce store for wholesale and retail:

1. Set wholesale-only products to **Online Only** (for B2B portal access)
2. Set retail exclusives to **POS Only**
3. Keep regular products as **POS & Online**

## Troubleshooting[​](#troubleshooting "Direct link to Troubleshooting")

Products still appearing after setting to Online Only

1. Open the POS
2. Long press the sync button at the bottom of the Product Panel
3. Select **"Clear and Refresh"**
4. Wait for products to reload

A POS Only product still shows up on the website

Open the product and look at **Catalog visibility** in the Publish box. For a POS Only product it reads **Hidden** and cannot be edited. If it shows anything else, a plugin or custom code on your site is changing the decision with the `wcpos_pos_only_catalog_visibility` filter described above; otherwise update the product once and WCPOS re-applies Hidden.

If it already reads Hidden, the page is most likely cached. A caching plugin or CDN can keep serving a shop or search page rendered before the product became POS Only. Clear the site cache after changing visibility.

Opening the product from a direct link still shows its page. That is also how WooCommerce's own Hidden visibility behaves. The product cannot be added to the cart from that page.

Setting not showing on products

Make sure the feature is enabled:

1. Go to **WP Admin > POS > Settings > General**
2. Verify **"Enable POS Only Products"** is checked
3. Save settings if you made changes

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

[WP Admin General SettingsEnable the feature](/settings/wp-admin/general.md)

[Product PanelThe POS product browsing interface](/pos/product-panel.md)

[Product SynchronisationHow products sync between WooCommerce and POS](/products/sync.md)
