Skip to main content
Preview availability
Menu
Type to search across all documentation
↑↓NavigateEnterOpenEscClose
4 min read

Performance

Measure storefront loading, search responsiveness, asset cost and layout stability under defined conditions.

FilterIQ adds search and filtering to a Shopify theme. Its effect on loading and responsiveness depends on the theme, catalogue, device, network, active configuration and cache state. Measure the actual published combination before making a performance commitment.

Asset and loading inspection

The extension contains layout styles, filter rendering, instant search, mobile drawer, analytics and accessibility modules. The set requested by a page depends on its integration and configuration. Source-file sizes are not a measurement of the transferred page payload.

In browser developer tools, record the actual asset URLs, compressed transfer sizes, initiators and loading order. Include styles, scripts, images, fonts and API responses; distinguish cached transfers from cold requests. Inspect the published version rather than adding together selected source files.

Earlier versions of this guide published approximate bundle totals and an industry-average comparison without a linked measurement artifact. Those numbers are not an established comparison and have been withdrawn. No competitor speed or bundle advantage is claimed here.

Loading strategy

Inspect the page's render-blocking styles, deferred scripts and image dimensions in the browser network and performance panels. A deferred script still performs work after it loads. Critical layout styles can reserve space, but their presence alone does not prove that a particular theme remains stable.

Check font requests and fallbacks from the actual page. Do not assume an extension font, a fixed execution order or universal theme behavior from this guide. Keep the supported Theme App Extension integration, and verify custom changes on a duplicate theme.

Layout stability

Test initial loading and the complete filter journey: drawer opening, selected values, result refresh, reset and empty results. Watch for grid movement, clipped labels, late image sizing and unexpected scroll jumps. Include narrow mobile widths and a slow network.

Measure CLS with the browser's layout-shift entries and inspect their affected elements. Report the observation window and whether shifts followed user input. Layout protection is a mitigation, not a promise of zero movement on every theme.

Search and API timing

Keep these measurements separate:

  • Search-engine processing: work within the engine for a defined request.
  • HTTP round trip: the measured endpoint request through receipt of its response.
  • Input-to-visible results: user input through the settled results rendered in the browser.
  • Index freshness: a source change through verified searchable output.

A quick engine response does not establish a quick shopper experience. Include input handling, proxy routing, cache state, network travel, rendering and failures. The earlier typical API timings are not supported by a repeatable benchmark linked here.

Repeatable comparison

Use the same theme version, catalogue, query/filter set, viewport, device profile, connection and consent state for the baseline and candidate. Record release identifiers, location, cold/warm cache conditions, concurrency, number of samples and failed requests. Compare distributions rather than choosing the fastest run.

For page loading, record LCP and CLS alongside transferred bytes and rendering work. For interactions, inspect input responsiveness and result updates. A Lighthouse run is a synthetic observation; it is not field performance or a conversion study. This guide does not promise a fixed score change.

Optimizing and investigating

  1. Identify the slow or unstable interval before changing code.
  2. Check catalogue sync, query complexity and active filters when results are slow or missing.
  3. Inspect render-blocking resources and custom scripts that modify the product grid.
  4. Test a change on a duplicate theme and retain the previous configuration for rollback.
  5. Re-run the same scenario and verify both result correctness and the measured interval.

See the architecture guide for system boundaries. Share the release, scenario and measurements with support without including tokens, customer records or raw sensitive search terms.

Was this page helpful?