Cartly v1.17 — Storefront Faceted Filtering: Auto-Detected, Merchant-Configurable

Cartly collection pages now have faceted filters — the kind of sidebar filter panel that customers use on every major e-commerce site to narrow by colour, size, price, or any custom attribute you define. And the best part: they appear automatically, with no theme changes required.

How It Works

When a customer opens a collection page, Cartly queries Typesense for both the product list and facet counts in a single request. The platform builds a filter sidebar from those counts and injects it into the Liquid context as collection.filters. Your theme renders it — and if you are using a Cartly marketplace theme (Linen, Vogue, TechPro, Crafter), the sidebar is already wired up.

Filters are fully URL-driven. Every value has a url_to_add and a url_to_remove link — so filter chips are just anchor tags, no JavaScript required. Sort order and pagination are preserved across filter changes.

Auto-Detected Filters

The platform automatically creates filter groups for:

• Variant options — Color, Size, or any option key you use. If your products have a Size option with values S, M, L, a Size filter appears automatically.
• Product tags — tag-based facet bucket.
• Vendor — shown when at least one product has a vendor set.
• Availability — in-stock only toggle.
• Price range — min/max from your actual product prices.

Customise Your Filters

Go to Admin → Settings → Storefront Filters to take control of the defaults:

• Reorder — drag filters into the order that makes sense for your catalogue.
• Relabel — rename "Color" to "Colour" or "Farbe" for your market.
• Change display type — swatches instead of chips for colour filters, a range slider for price.
• Hide — suppress filters that are not relevant to your product range.
• Scope — apply an override to all collections (GLOBAL) or only to a specific one.

Custom Filters for Any Product Attribute

Want to filter by Brand, Material, or Width? Create a Metafield Definition at Settings → Custom Data → Product Metafields, check "Available as filter on collection pages", and assign values to your products. That attribute becomes a filter automatically — no developer help required.

The two-step flow:

1. Define the metafield — Cartly extends the Typesense schema automatically.
2. Assign values per product — each save reindexes that product. New facet buckets appear as soon as products have values.

URL Structure

Filters are bookmarkable and shareable. The URL scheme is clean and consistent:

/collections/t-shirts?filter.v.option.color=Red&filter.v.price.gte=2000&sort_by=price-ascending

Developer Resources

• Storefront Faceted Filtering guide — URL param reference, Liquid globals, API endpoints, custom filters.
• Full Changelog v1.17.0