Storefront Filters — Overview
What Are Storefront Filters?
Storefront filters are the sidebar filter panels that appear on your collection pages. They let customers narrow the product list by colour, size, price, tags, or any custom attribute you define. Filters are powered by Typesense and update results instantly without a page reload.
Filters That Appear Automatically
Cartly detects your product data and creates filter groups automatically — no configuration needed:
- Variant options — every option key on your variants (e.g. Color, Size, Material) becomes a filter group. Values are populated from your actual product data.
- Product tags — if your products use tags, a Tags filter appears.
- Vendor — appears when at least one product has a vendor set.
- Availability — in-stock only toggle.
- Price range — min/max range from your actual prices.
Customising Your Filters
Go to Admin → Settings → Storefront Filters to customise the defaults. For each filter you can:
- Reorder — drag the handle to move filters up or down in the sidebar.
- Relabel — change the display name (e.g. rename "Color" to "Colour" for your market).
- Change display type — chips (default), swatches (for colours), range slider (for price), radio buttons, or checkboxes.
- Hide — suppress filters that are not relevant to your product range.
- Scope — apply overrides to all collections (Global) or only to a specific collection.
Click + Add filter to customise a filter that does not yet have an override. The modal groups available filters by type: built-in, variant options, and product metafields.
Reindexing
Your product index updates automatically whenever you save product changes. However, some situations require a full reindex:
- You created a new filterable Metafield Definition.
- You suspect the filter counts are out of date.
Click Reindex products in Settings → Storefront Filters. A progress bar shows the indexing status. For large catalogues this takes up to a few minutes.
Which Theme Template Do I Need?
If you are using one of the Cartly marketplace themes (Linen, Vogue, TechPro, Crafter), the filter sidebar is already built in — no code changes needed. If you are using a custom theme, add the filter rendering code to your collection section. See the developer guide for the Liquid snippet.