faceted-navigation

Implements multi-attribute product filtering with URL-driven state for ecommerce listing pages.

3|1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill faceted-navigation-tomtoto757
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: faceted-navigation
Source: https://github.com/tomtoto757/ecomm-ai-team/tree/main/skills/storefront-shopping-experience/finsilabs/storefront-ui/faceted-navigation
Command: npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill faceted-navigation-tomtoto757

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shoppers on catalogs with more than 50 SKUs struggle to narrow down products when filters are missing, break the back button, or lose state on refresh and sharing. This Skill guides the implementation of faceted navigation where filter selections live in the URL, making results shareable, bookmarkable, and crawlable. ## Core Features & Use Cases - Platform-Specific Setup: Step-by-step configuration for Shopify (Search & Discovery app), WooCommerce (FiboSearch or Product Filters), BigCommerce (native Faceted Search), and custom headless builds with Algolia or Elasticsearch. - URL State Management: Reference JavaScript utilities for parsing and building query strings with multi-value facets, pushState history handling, and disjunctive facet logic (OR within a facet, AND between facets). - Mobile and UX Patterns: Guidance on mobile filter drawers, active filter pills, clear-all controls, facet count freshness, and price range slider debouncing. - Use Case: A merchant on Shopify with a 500-SKU shoe catalog uses this Skill to enable color, size, and brand filters with shareable URLs like /shoes/running?color=black&size=10, then configures a mobile filter drawer and active filter pills. ## Quick Start Ask the AI to build a filterable product listing page for your platform with URL-synced multi-select facets for brand, color, size, and price range.

Frequently Asked Questions about faceted-navigation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add product filters to a Shopify collection page?▼

Install the free Search & Discovery app, add filters under Apps → Search & Discovery → Filters, then enable filtering in your OS2.0 theme's collection template. Dawn and similar themes support native storefront filtering via the Storefront API.

How to build faceted search with Algolia for a headless store?▼

Encode active filters as repeated query params in the URL, then pass them to Algolia as facetFilters grouped per facet key for OR-within, AND-between logic. Apply price ranges as numeric filters like 'price >= 50' rather than facetFilters entries.

WooCommerce product filters: FiboSearch vs free Product Filters plugin?▼

FiboSearch ($49/yr) adds AJAX filtering, price sliders, color swatches, and stock filters. The free WooCommerce Product Filters plugin covers basic attribute filtering with URL state via the [woof] shortcode.

Why does the back button reload the page instead of removing a filter?▼

This happens when filter changes use history.replaceState or only JavaScript state. Use history.pushState for each filter change so every selection creates a history entry, and add a popstate listener to re-sync state.

Does BigCommerce support faceted search natively?▼

Yes, BigCommerce includes Faceted Search under Storefront → Search settings, supporting brand, category, price, rating, and custom fields. It requires Stencil-based themes like Cornerstone; legacy Blueprint themes do not support it.

How do I prevent duplicate content SEO issues from facet URLs?▼

Add rel="noindex" or canonical tags for non-primary facet combinations so search engines do not index every filter permutation. In Shopify, this is configured through the Search & Discovery app's SEO settings.