> For the complete documentation index, see [llms.txt](https://docs.momocode.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.momocode.de/en/shopware-6/product-completeness/1.-description.md).

# 1. Description

**Product Completeness & Data Quality** analyses your product catalog and calculates a completeness score from 0 to 100% for every product. At a glance you can see which products have incomplete descriptions, missing images, or insufficient SEO metadata — and where there is room to improve conversions.

## What the plugin does

The plugin adds three areas to the native Shopware Admin:

### Dashboard

The dashboard gives you an immediate overview of your catalog's data quality:

* **Score distribution**: How many products are "Good", "Average", or "Critical"?
* **Average score**: A single number summarising the overall catalog health
* **Missing fields**: The five most common data gaps across your products
* **Validation summary**: How many products pass your mandatory field checks?

![Dashboard with score distribution and missing fields](/files/iKYiA9Hl5LC5QTw13Zqz)

### Dedicated product list

The **Product List** tab provides a dedicated product overview with score and validation status columns, plus filters by score range, missing field, and validation status.

![Dedicated product list with scores and filters](/files/k8YulJHPHvAkCdOpze3Y)

### Score and validation columns in the product list

Two new columns appear automatically in the native Shopware product list:

* **Completeness**: A color-coded badge (Green / Orange / Red) showing the current score
* **Valid**: A status badge indicating whether the product passes all validation rules

Both columns are filterable and sortable — no configuration required.

![Score and validation columns in the product list](/files/rZrO8j1vcEpEsOA90rrG)

### Score card on the product detail page

On every product detail page, the plugin displays a score card. It shows the current score and lists exactly which fields are still missing or incomplete for that specific product.

![Score card on the product detail page](/files/tZzp8e2Bs8ah1QYrBdUt)

## Rule-based evaluation

Scores are not calculated with a fixed formula — they are driven by configurable **rule sets** that you define yourself:

* Which fields matter (name, description, images, categories, custom fields, …)
* How much weight each field carries
* Whether a field should be checked as a binary pass/fail (validation rule)
* Which sales channels and languages a rule set applies to

The plugin automatically detects all compatible fields from Shopware's `ProductDefinition` — text fields, numbers, images, categories, tags, custom fields, and more.

## Asynchronous calculation

Score calculation runs via the **Symfony Messenger** in the background. Product saves in the Admin return immediately — no timeouts, no waiting. Scores are automatically recalculated every time a product is saved.