# 1. Description

**Sold Count Display & Social Proof** shows real sales figures directly on product detail pages and in product listings. Instead of fake FOMO popups, this plugin uses credible, static badges backed by actual order data.

![Badge on the product detail page](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-0061bc16f9db4d08dd02396ebba6b55bdc609527%2F1.png?alt=media)

## What the plugin does

The plugin aggregates sold counts from completed and paid orders daily and stores them in a dedicated database table. These figures are then surfaced in your shop in two ways:

* **Product detail page:** A badge in the buy widget area shows how often a product has been sold (e.g. "1,800+ sold")
* **Product listings:** Compact badges on product cards in categories and search results

## Top Sellers widget in the admin

The plugin adds a **Top Sellers** widget to the admin dashboard, listing the 10 best-selling products with their rank, name, product number, and sold count. Each row links directly to the product detail page in the admin.

![Top Sellers widget on the admin dashboard](https://459847022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-1972196547%2Fuploads%2Fgit-blob-74f22175af53890957b8574a5091601e345442df%2F3.png?alt=media)

## Key highlights

* **Real data:** Only completed and paid orders are included in the aggregation
* **Variant rollup:** Sales from all variants are summed to the parent product
* **Configurable:** Minimum threshold, rounding options, and a time period filter control what gets displayed
* **Performant:** Aggregation runs once a day as a background task — not on every page load

## Areas extended in Shopware

| Area                                   | Extension                                         |
| -------------------------------------- | ------------------------------------------------- |
| Storefront – Product detail page       | Sold count badge in the buy widget                |
| Storefront – Product listings & search | Compact badge on product cards                    |
| Admin – Dashboard                      | Top Sellers widget                                |
| Admin – Plugin configuration           | Settings for threshold, rounding, and time period |