Live Viewers Manual.

How to show honest live-viewer and sales figures on the product detail page and make social proof visible.

System requirements

Shopware 6.7, PHP 8.1 or newer, MySQL or MariaDB. The Shopware scheduler or a worker must be running so old heartbeats are cleaned up automatically.

No external services: Counting runs entirely on your own server. No data is sent to third parties.

Installation

  1. Upload the ZIP through the Shopware backend.
  2. Install and activate the plugin.
  3. Open the settings under Extensions, Stone & Water - Live Viewer & Sales Counter, Configuration.
  4. Pick the position on the product detail page, set the minimum thresholds and add custom texts if you want.
  5. Clear the storefront cache.

Opening the settings

The settings live in the admin under Extensions, in the plugin configuration. They are grouped into four cards, each described below.

Live viewers: how counting works

When a product detail page is opened, an anonymous heartbeat is registered. A storefront JavaScript sends further heartbeats at a configurable interval for as long as the tab is active. All sessions within a configurable time window are counted, five minutes by default.

The visitor is not counted: The current session is always excluded. Customers see other people, not themselves.

Sales counter: how counting works

Sales figures come straight from order_line_item, so from real orders. Variants are aggregated onto the parent product, meaning one article in three sizes counts together. The time window is configurable, seven days by default.

The three display modes

Each data source can be set separately to control how specific the number appears.

Strict
The exact number, for example „3 people are looking at this item right now".
Bucketed
Honest ranges with fixed boundaries: 3 to 5, 6 to 15, 16 and above. The label per range is free text.
Aggregated live viewers only
„X people in the last 24 hours" - useful when there is not enough simultaneous traffic for a live figure.

Minimum threshold

Each data source has a threshold below which nothing is shown at all. This avoids misleading signals when activity is low - a single visitor on the page is not convincing social proof.

Display positions

The badge can appear in four places on the product detail page: above the buy box, below the buy box, directly above the add-to-cart button and directly below it. Together with the option to show nothing, the dropdown offers five choices.

The four settings cards

Display positions
Where the badge appears on the product detail page.
Data source: viewed
Mode, minimum threshold, time window, heartbeat interval, custom texts and the range labels.
Data source: sold
Mode, minimum threshold, time window, custom text and the range labels.
Transparency
Optional explanation link for customers.

Custom texts and placeholders

Every text can be overridden. Two placeholders are available: %count% for the number and %days% for the time window in days.

The bundled default texts are:

Viewed, strict
%count% people are looking at this item right now
Viewed, aggregated
%count% people viewed this item in the last 24 hours
Sold, strict
Sold %count% times in the last %days% days

Further languages can be added through the Shopware snippet system; German and English ship with the plugin.

Transparency link

Optionally a „How we measure this" link appears next to the badge, pointing at a URL of your choice. Useful if you want to explain on your own page that these numbers are counted, not estimated.

Privacy

The only things stored are a SHA-256 hash of the session ID and sales channel ID, plus product ID, sales channel ID and timestamps. The hash cannot be reversed.

Not stored: no IP addresses, no user agent strings, no cookies, no transfer to third-party services.

Heartbeats older than 25 hours are removed automatically every five minutes by a scheduled task.

Troubleshooting

Nothing is displayed

Usually the minimum threshold: as long as fewer sessions or sales are counted than configured, the badge stays hidden on purpose. Also check that a display position is selected and the storefront cache has been cleared.

The number looks too low

Your own session is never counted. Testing in your own browser will always show one less than is actually active.

The number does not change

Check the time window and the heartbeat interval. If the interval is longer than the window, sessions drop out of the count before the next heartbeat arrives.

Old entries are not removed

Cleanup runs as a scheduled task. Without a running scheduler or worker it never executes.

Support

If you have questions about setup or picking sensible thresholds, we are happy to help. Get in touch via the contact page or write to info@stoneandwater.online.

Through the store or directly from us.

Two routes, the same feature set - pick whichever suits your setup.

Directly from Stone & Water

Available right now

Monthly4,99 €
Half-yearly24,99 €17 % cheaper
Best valueYearly44,99 €25 % cheaper

All prices net, plus VAT.

You buy the licence directly from us and get an invoice from us. Install by upload in the admin without SSH, updates through our licensing platform, support straight from the developer.

Ask us directly +49 2555 9997342

Shopware Store

Available now

Listed in the official Shopware Community Store. Installation and updates run through the plugin manager, billing through your Shopware account. Store conditions differ from ours.

View in the Shopware Store

More trust in the shop?

Back to Live Viewers.

All features on the product page. We are here for setup and fine-tuning.