Free & Open Source v1.0.0 Magento 2.4.x, PHP 8.2+

Catalog Quality for Magento 2

Product Health Scoring, filter-blind detection, and a revenue-weighted Catalog Health Index — know exactly which products are hurting your conversion rate before your customers find out.

View on GitHub composer require magendoo/module-catalog-quality

Features

Product Health Score (PHS)

Every product gets a 0–100 score and an A–E letter grade based on two axes: Enrichment (are the important attributes filled in?) and Consistency (do they meet your content rules?). Instantly see which products are dragging down your catalog.

Catalog Health Index (CHI)

A single revenue-weighted number that summarises catalog quality across your entire store. Weights products by 90-day revenue so that gaps on your best-sellers count more than gaps on slow movers. Nightly snapshots power a 30-day trend chart on the dashboard.

Filter-Blind Detection

Flags every product that has no value for a filterable attribute — products that vanish completely when shoppers use category filters in layered navigation. Red chips in the Gap List show exactly which filterable attributes are causing each product to disappear.

Filter Coverage Matrix

A heatmap of attribute fill rates per category, colour-coded from green (≥90%) to red (<35%). Click any cell to open the Gap List pre-filtered to exactly those products — the fastest path from diagnosis to action.

Attribute Priority System

P1–P4 and Ignore priority levels, configurable per attribute, attribute set, and category. Filterable attributes auto-floor at P2. An inline-editable grid lets you adjust priorities without leaving the listing — no developer required.

REST API & CLI Tools

6 REST endpoints for scores and priority rules. CLI commands for full reindex, single-SKU debugging, and CSV export. Incremental MView updates mean products are re-scored on save — no nightly full reindex needed.

Screenshots

Catalog Quality Dashboard showing Catalog Health Index, grade distribution, and 30-day CHI trend
Dashboard — Catalog Health Index, grade distribution, filter-blind count, and 30-day trend chart
Product Gap List showing PHS scores, grade badges, filter-blind chips, and missing attribute codes per product
Product Gap List — every scored product with grade, PHS, gap counts, and colour-coded missing attribute chips
Filter Coverage Matrix heatmap showing attribute fill rates per category, colour-coded from green to red
Filter Coverage Matrix — attribute fill-rate heatmap per category; click any cell to open the pre-filtered Gap List

Use Cases

  • Identify products hurting conversion before your customers find out
  • Catch filter-blind products that vanish in layered navigation when shoppers filter by colour, size, or material
  • Prioritise catalog enrichment work by revenue impact using the weighted CHI
  • Audit attribute coverage before catalog migrations, re-platforming, or PIM onboarding
  • Monitor long-term catalog quality trends with nightly CHI snapshots and a 30-day trend chart
  • Integrate base-price compliance fields from Magendoo_BasePrice via conditional attribute groups

Installation

Install via Composer (recommended)

composer require magendoo/module-catalog-quality
bin/magento module:enable Magendoo_CatalogQuality
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Manual Installation

  1. Copy the module directory into app/code/Magendoo/CatalogQuality/
  2. Run the same CLI commands listed above

Initial Setup

After installation, run the full indexer to score all products. This may take several minutes on large catalogs — batch size is configurable under Stores → Configuration → Magendoo Extensions → Catalog Quality → Performance.

bin/magento indexer:reindex magendoo_cq_product_score

Then navigate to Catalog Quality in the top-level admin menu to see the dashboard, Product Gap List, Filter Coverage Matrix, and Attribute Priorities.

REST API

All endpoints require an admin bearer token. Authenticate with POST /V1/integration/admin/token.

MethodEndpointDescription
GET/V1/catalog-quality/scores/:skuQuality score for a single SKU
GET/V1/catalog-quality/gapsList gap records with search criteria support
POST/V1/catalog-quality/prioritiesCreate or update a single priority rule
POST/V1/catalog-quality/priorities/bulkBulk upsert priority rules
GET/V1/catalog-quality/prioritiesList all priority rules
DELETE/V1/catalog-quality/priorities/:idDelete a priority rule

Configuration

Navigate to Stores → Configuration → Magendoo Extensions → Catalog Quality.

SettingDefaultDescription
EnabledYesMaster switch for the module
Revenue-weighted CHIYesWeight the Catalog Health Index by 90-day product revenue. Disable for equal-weight averaging.
Indexer Batch Size500Products scored per batch during full reindex. Reduce on low-memory servers.
Snapshot Retention90 daysHow long nightly CHI snapshots are kept before automatic cleanup.

Admin Screens

ScreenDescription
DashboardCHI score, grade distribution, filter-blind product count, 30-day trend chart
Product Gap ListAll scored products with grade, PHS, gap counts, and filter-blind chips. Filterable by grade and filter-blind status.
Filter Coverage MatrixHeatmap of filterable attribute fill rates per category. Click-through to filtered Gap List.
Attribute PrioritiesInline-editable P1–P4/Ignore priority rules per attribute, attribute set, and category.

Need help with installation or customization?

Every module is built for production, but every store is different. If you need integration, customization, or enterprise support — let's talk.

Get in Touch GitHub
22+ Years in Commerce Engineering
50+ Enterprise Magento Projects
EU Based in Europe, Serving Europe
OSS Open Source Contributor
Get a Proposal • 24h response Call