How to use Hallwil Filters

Hallwil Filters adds fast collection filters, search, and product discovery to your Shopify storefront. This guide walks you through setup from install to a live theme integration.

1. Install and open the app

Install Hallwil Filters from the Shopify App Store and approve the requested permissions. Open the app from Shopify Admin → Apps.

The home screen shows catalog index status, your current plan, and a setup checklist. Complete the checklist to get your storefront ready.

  • Install the app on your development or production store.
  • Open Hallwil Filters from the Shopify admin sidebar.
  • Confirm the catalog index starts automatically after install.

2. Catalog indexing

The app indexes your products into a search engine (Typesense) so filters and search respond in milliseconds. Indexing runs in the background after install or when you trigger a reindex.

While indexing is in progress, filter counts may be incomplete. Wait until the status shows Ready on the home page or settings.

  • Pending / Indexing — catalog sync is running.
  • Ready — storefront API can return full filter and product data.
  • Error — check Redis connectivity and use Reindex catalog in Settings.

3. Create filter sets

Go to Filters in the app navigation. A filter set defines which filters appear on specific collection or search pages.

Add filters sourced from product options, vendor, type, tags, price, availability, or metafields. Configure display types (checkbox, swatch, range) and sort order.

  • Create a filter set and assign collection handles or use it as the default for search.
  • Add filters and map each one to a product attribute.
  • Preview facet counts from the filter set editor when the index is ready.

4. Storefront integration

Your theme calls the Discovery API through Shopify App Proxy at /apps/discovery/v1/*. Shopify signs each storefront request automatically — do not add signature or timestamp in theme code.

Use the App Proxy URL shown in Settings or the in-app Documentation page. Typical endpoints: /v1/filters, /v1/products, /v1/search/suggest.

For Liquid and JavaScript examples, open Documentation inside the embedded app (shop-specific proxy URL and code samples).

5. Billing and plans

Subscription plans are managed through Shopify Billing. Open Billing in the app to view your plan, upgrade, or cancel.

Plan limits (filter sets, markets, indexing volume) apply according to the tier shown on the Billing page.

6. Migration and catalog tools

Use Migration to export or import product attributes aligned with your filters (vendor, tags, options, metafields) via Excel.

Use Catalog overview on the home page to inspect indexed products and facet coverage.

7. Support and resources

Embedded Documentation (Shopify admin → Hallwil Filters → Documentation) includes API examples and theme integration code for your store.

Interactive OpenAPI documentation is available on the Discovery API service when deployed.

  • In-app Documentation — API examples and theme snippets.
  • API reference (Swagger) — full request/response schemas.
  • Settings — language, reindex, App Proxy URL, legal links.