From e18291710313c04360da8bdf73faf852dc7fa7d1 Mon Sep 17 00:00:00 2001
From: indy koning <indy@justbetter.nl>
Date: Thu, 13 Aug 2026 17:01:35 +0200
Subject: [PATCH 1/4] Hide irrelevant filters when they barely return products

---
 config/rapidez/searchkit.php                  |  5 +++
 resources/js/components/Listing/Listing.vue   | 40 +++++++++++++++++++
 .../listing/partials/filter/boolean.blade.php |  2 +-
 .../listing/partials/filter/select.blade.php  |  2 +-
 .../listing/partials/filter/swatch.blade.php  |  2 +-
 5 files changed, 48 insertions(+), 3 deletions(-)

diff --git a/config/rapidez/searchkit.php b/config/rapidez/searchkit.php
index 0da079bfa..bb029c73d 100644
--- a/config/rapidez/searchkit.php
+++ b/config/rapidez/searchkit.php
@@ -59,6 +59,11 @@
         ['attribute' => 'visibility', 'field' => 'visibility', 'type' => 'numeric'],
     ],
 
+    // The minimum percentage of products that should be available for a filter to be shown.
+    // For example, if you have 100 products in the listing and a filter has only 5 products available,
+    // the filter will not be shown because it is only available for 5% of the products.
+    'min_filter_product_percentage' => 10,
+
     // Additional sorting options to be added to the product listings
     // Given directions can only be an array of 'asc' and/or 'desc'
     // Order shown here will be the order shown in the dropdown (including the order of the given directions!)
diff --git a/resources/js/components/Listing/Listing.vue b/resources/js/components/Listing/Listing.vue
index 42166e7b3..205f85c7a 100644
--- a/resources/js/components/Listing/Listing.vue
+++ b/resources/js/components/Listing/Listing.vue
@@ -8,6 +8,7 @@ import RangeInput from 'vue-instantsearch/vue3/es/src/components/RangeInput.vue.
 import HierarchicalMenu from 'vue-instantsearch/vue3/es/src/components/HierarchicalMenu.vue.js'
 import RefinementList from 'vue-instantsearch/vue3/es/src/components/RefinementList.vue.js'
 import SortBy from 'vue-instantsearch/vue3/es/src/components/SortBy.vue.js'
+import { instantsearchMiddlewares } from '../../stores/useInstantsearchMiddlewares'
 
 export default {
     mixins: [InstantSearchMixin],
@@ -59,6 +60,7 @@ export default {
         searchClient: null,
         destroyed: false,
         utmFields: [],
+        instantSearchInstance: null,
     }),
 
     render() {
@@ -127,6 +129,19 @@ export default {
     },
 
     methods: {
+        getMiddlewares() {
+            return [
+                ({ instantSearchInstance }) => {
+                    this.instantSearchInstance = instantSearchInstance
+                    return {
+                        onStateChange: () => {},
+                        subscribe: () => {},
+                        unsubscribe: () => {},
+                    }
+                },
+                ...instantsearchMiddlewares
+            ]
+        },
         async getInstantSearchClientConfig() {
             const config = await InstantSearchMixin.methods.getInstantSearchClientConfig.bind(this).call()
 
@@ -256,6 +271,31 @@ export default {
                 ...item,
             }))
         },
+
+        isRelevantFilter(filterItems, minProductPercentage = null) {
+            if (!filterItems?.length) {
+                return false
+            }
+
+            if (filterItems.some((item) => item.isRefined)) {
+                return true
+            }
+
+            if (!this.instantSearchInstance) {
+                return true
+            }
+            const totalHits = this.instantSearchInstance?.helper?.lastResults?.nbHits;
+            if (!totalHits) {
+                return true
+            }
+            if (isNaN(minProductPercentage) || minProductPercentage === null) {
+                minProductPercentage = window.config.searchkit.min_filter_product_percentage ?? 10
+            }
+
+            const resultCount = filterItems.reduce((sum, item) => item.count + sum, 0)
+
+            return resultCount / totalHits > minProductPercentage / 100
+        }
     },
 }
 </script>
diff --git a/resources/views/listing/partials/filter/boolean.blade.php b/resources/views/listing/partials/filter/boolean.blade.php
index ed043d4cd..b7aa6b5a8 100644
--- a/resources/views/listing/partials/filter/boolean.blade.php
+++ b/resources/views/listing/partials/filter/boolean.blade.php
@@ -6,7 +6,7 @@ class="relative -mx-1 -mt-1"
 >
     <template v-slot="{ items, refine }">
         <div class="overflow-clip">
-            <x-rapidez::accordion.filter v-show="items.length" class="details-content:overflow-visible px-1 py-1">
+            <x-rapidez::accordion.filter v-show="listingSlotProps.isRelevantFilter(items)" class="details-content:overflow-visible px-1 py-1">
                 <x-slot:content>
                     <div class="flex flex-col *:py-1 *:first:pt-0 *:last:pb-0 items-start">
                         <template v-for="item in items">
diff --git a/resources/views/listing/partials/filter/select.blade.php b/resources/views/listing/partials/filter/select.blade.php
index 539f7c016..958685f8e 100644
--- a/resources/views/listing/partials/filter/select.blade.php
+++ b/resources/views/listing/partials/filter/select.blade.php
@@ -8,7 +8,7 @@ class="relative -mx-1 -mt-1"
 >
     <template v-slot="{ items, refine, isShowingMore, toggleShowMore, canToggleShowMore }">
         <div class="overflow-clip">
-            <x-rapidez::accordion.filter v-show="items.length" class="details-content:overflow-visible px-1 py-1" canToggleShowMore>
+            <x-rapidez::accordion.filter v-show="listingSlotProps.isRelevantFilter(items)" class="details-content:overflow-visible px-1 py-1" canToggleShowMore>
                 <x-slot:content>
                     <div class="flex flex-col *:py-1 *:first:pt-0 *:last:pb-0 items-start">
                         <template v-for="item in items">
diff --git a/resources/views/listing/partials/filter/swatch.blade.php b/resources/views/listing/partials/filter/swatch.blade.php
index e86cc613d..52787eaac 100644
--- a/resources/views/listing/partials/filter/swatch.blade.php
+++ b/resources/views/listing/partials/filter/swatch.blade.php
@@ -6,7 +6,7 @@ class="relative"
 >
     <template v-slot="{ items, refine, isShowingMore, toggleShowMore, canToggleShowMore }">
         <div class="overflow-clip">
-            <x-rapidez::accordion.filter class="details-content:overflow-visible" v-show="items.length" canToggleShowMore>
+            <x-rapidez::accordion.filter class="details-content:overflow-visible" v-show="listingSlotProps.isRelevantFilter(items)" canToggleShowMore>
                 <x-slot:content>
                     <ul class="flex flex-wrap gap-x-1.5 gap-y-2 items-center pr-14">
                         <li v-for="item in listingSlotProps.withSwatches(items, filter)">

From fa2c81c25db1e5f7177f09a1e7f1fdf70e574238 Mon Sep 17 00:00:00 2001
From: indykoning <indykoning@users.noreply.github.com>
Date: Thu, 13 Aug 2026 15:02:22 +0000
Subject: [PATCH 2/4] Apply fixes from Prettier

---
 resources/js/components/Listing/Listing.vue | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/resources/js/components/Listing/Listing.vue b/resources/js/components/Listing/Listing.vue
index 205f85c7a..51f00a3f1 100644
--- a/resources/js/components/Listing/Listing.vue
+++ b/resources/js/components/Listing/Listing.vue
@@ -139,7 +139,7 @@ export default {
                         unsubscribe: () => {},
                     }
                 },
-                ...instantsearchMiddlewares
+                ...instantsearchMiddlewares,
             ]
         },
         async getInstantSearchClientConfig() {
@@ -284,7 +284,7 @@ export default {
             if (!this.instantSearchInstance) {
                 return true
             }
-            const totalHits = this.instantSearchInstance?.helper?.lastResults?.nbHits;
+            const totalHits = this.instantSearchInstance?.helper?.lastResults?.nbHits
             if (!totalHits) {
                 return true
             }
@@ -295,7 +295,7 @@ export default {
             const resultCount = filterItems.reduce((sum, item) => item.count + sum, 0)
 
             return resultCount / totalHits > minProductPercentage / 100
-        }
+        },
     },
 }
 </script>

From a4351e41a6ac12ee4648d22eb8f79b826802d10a Mon Sep 17 00:00:00 2001
From: indy koning <indy@justbetter.nl>
Date: Thu, 20 Aug 2026 10:34:36 +0200
Subject: [PATCH 3/4] Added range relevancy

---
 resources/js/components/Listing/Listing.vue   | 22 +++++++++++++++++++
 .../listing/partials/filter/price.blade.php   |  2 +-
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/resources/js/components/Listing/Listing.vue b/resources/js/components/Listing/Listing.vue
index 51f00a3f1..ae04ba75a 100644
--- a/resources/js/components/Listing/Listing.vue
+++ b/resources/js/components/Listing/Listing.vue
@@ -294,6 +294,28 @@ export default {
 
             const resultCount = filterItems.reduce((sum, item) => item.count + sum, 0)
 
+            return resultCount / totalHits > minProductPercentage / 100
+        },
+        isRelevantRange(filterCode, minProductPercentage = null) {
+            if (Object.keys(this.instantSearchInstance?.helper?.state?.numericRefinements?.[filterCode] || {}).length) {
+                return true
+            }
+
+            if (!this.instantSearchInstance) {
+                return true
+            }
+
+            const totalHits = this.instantSearchInstance?.helper?.lastResults?.nbHits
+            const facetStats = this.instantSearchInstance?.helper?.lastResults?.facets_stats?.[filterCode]
+            if (!totalHits || !facetStats) {
+                return true
+            }
+            if (isNaN(minProductPercentage) || minProductPercentage === null) {
+                minProductPercentage = window.config.searchkit.min_filter_product_percentage ?? 10
+            }
+
+            const resultCount = facetStats.sum / facetStats.avg
+
             return resultCount / totalHits > minProductPercentage / 100
         },
     },
diff --git a/resources/views/listing/partials/filter/price.blade.php b/resources/views/listing/partials/filter/price.blade.php
index 168860311..870467066 100644
--- a/resources/views/listing/partials/filter/price.blade.php
+++ b/resources/views/listing/partials/filter/price.blade.php
@@ -4,7 +4,7 @@
     class="relative -mx-1 -mt-1"
 >
     <template v-slot="{ currentRefinement, range, canRefine, refine, sendEvent }">
-        <div class="overflow-clip" v-show="range.max">
+        <div class="overflow-clip" v-show="range.max && listingSlotProps.isRelevantRange(filter.code)">
             <x-rapidez::accordion.filter class="details-content:overflow-visible px-1 py-1">
                 <x-slot:content>
                     <div class="flex flex-col">

From d269958e6dca58efffc2518126542d186d39670c Mon Sep 17 00:00:00 2001
From: indykoning <indykoning@users.noreply.github.com>
Date: Thu, 20 Aug 2026 08:52:25 +0000
Subject: [PATCH 4/4] [CI] Update Snapshots

---
 .../category-pagination-1-chromium-linux.png                  | 4 ++--
 .../category-pagination-1-firefox-linux.png                   | 4 ++--
 .../category-pagination-1-webkit-linux.png                    | 4 ++--
 .../category-with-simple-products-1-chromium-linux.png        | 4 ++--
 .../category-with-simple-products-1-firefox-linux.png         | 4 ++--
 .../category-with-simple-products-1-webkit-linux.png          | 4 ++--
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/tests/playwright/category.spec.js-snapshots/category-pagination-1-chromium-linux.png b/tests/playwright/category.spec.js-snapshots/category-pagination-1-chromium-linux.png
index a64cb0b7a..e21455736 100644
--- a/tests/playwright/category.spec.js-snapshots/category-pagination-1-chromium-linux.png
+++ b/tests/playwright/category.spec.js-snapshots/category-pagination-1-chromium-linux.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:ac4c1a5d8e15c6d316f2be916177e8c088a5efea4b6780ba76f93e443a6a39b1
-size 230148
+oid sha256:b1a4ca634ae2c1c5a701fa325e9e734d32bdd26afee592e8383c60c42e4c516d
+size 225585
diff --git a/tests/playwright/category.spec.js-snapshots/category-pagination-1-firefox-linux.png b/tests/playwright/category.spec.js-snapshots/category-pagination-1-firefox-linux.png
index f73fea2a9..aa088393c 100644
--- a/tests/playwright/category.spec.js-snapshots/category-pagination-1-firefox-linux.png
+++ b/tests/playwright/category.spec.js-snapshots/category-pagination-1-firefox-linux.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:346f6e97d711904f249f807bbe7ed07d1d8259144bffed67155c11b25fd79ee7
-size 268178
+oid sha256:e4fcdd26d3c033e7e1eb03b88715018ed47426c0a31fb5f1b336f8c2ac37fc18
+size 262337
diff --git a/tests/playwright/category.spec.js-snapshots/category-pagination-1-webkit-linux.png b/tests/playwright/category.spec.js-snapshots/category-pagination-1-webkit-linux.png
index 8a01d235f..7fa87a4a2 100644
--- a/tests/playwright/category.spec.js-snapshots/category-pagination-1-webkit-linux.png
+++ b/tests/playwright/category.spec.js-snapshots/category-pagination-1-webkit-linux.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:a65f6cf162e18ce845e819a8d6e588ab572532c21702102fe843605b44791dc0
-size 266123
+oid sha256:cf175d1244b996e2bd006697a21c7fe07ac4322f9390beff5f4c8c455691458e
+size 260443
diff --git a/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-chromium-linux.png b/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-chromium-linux.png
index 9e1375afd..e4d4f5f44 100644
--- a/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-chromium-linux.png
+++ b/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-chromium-linux.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:0b3f1ef91b8dd4c8d4d1e98d5dcbf29cb11cb5d385de9ff41529e5fb05f73c84
-size 446011
+oid sha256:8df4ba62fc6c5f32c770f81f2b9894f7dd41e6c106c406957cd86b0ac5889279
+size 441528
diff --git a/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-firefox-linux.png b/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-firefox-linux.png
index a972893d7..d4b51a9d1 100644
--- a/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-firefox-linux.png
+++ b/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-firefox-linux.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:40d02aaffbdc6c136bcaf75cadf8177cced5f8364a4ad6dce3eea54b486f41e6
-size 529033
+oid sha256:b796dbd37275e36a843e79f245821a6b33055c9fc06d10f84953638a01ab5456
+size 523501
diff --git a/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-webkit-linux.png b/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-webkit-linux.png
index aaf0ab5b5..115e56f71 100644
--- a/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-webkit-linux.png
+++ b/tests/playwright/category.spec.js-snapshots/category-with-simple-products-1-webkit-linux.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:c9bca4679ed933f4ec504efed5c523d70f8333a5e7417aa49976efe0aed64ae2
-size 504808
+oid sha256:0e833aaede673fd2d3be82cfe2bc47401237e0b95d4c10947c77d41d9f9ac0e6
+size 500054