Reference
Plugin Settings Performance Reference
Indexing, cache, counts, grouped products, bundles, query limits, and AJAX performance settings.
Search all docs pages.
This Reference page covers the Performance tab in Plugin Settings. It is a manual draft for the full option Reference, not a standalone public release of the whole Reference set.
Performance settings can affect speed, accuracy, and cache freshness across the whole catalog. Test these changes on a staging site when the catalog is large or uses many variations, grouped products, or bundled products.
Indexing And Cache
Enable Index Tables
- Public label: Enable Index Tables
- Location: Plugin Settings > Performance > Indexing And Cache
- Type: Toggle
- Default value: On
- Shown when: Always.
- Availability: Free
- What it does: Enables plugin index tables for faster filtering and count lookup.
- When to use: Keep it on for most stores, especially catalogs with many products, attributes, or variations.
- Side effects / performance notes: Index data must be rebuilt when catalog structure changes significantly.
- Related options: Rebuild Index, Variation Filtering Mode, Display Variations in Results.
Cache Filter Results
- Public label: Cache Filter Results
- Location: Plugin Settings > Performance > Indexing And Cache
- Type: Toggle
- Default value: Off
- Shown when: Always.
- Availability: Free
- What it does: Stores filtered result data so repeated requests can be served faster.
- When to use: Use it on catalogs where many shoppers repeat common filter combinations.
- Side effects / performance notes: Cached results can become stale until cache expiration or rebuild events refresh them.
- Related options: Cache TTL, Transient Prefix, Rebuild Index.
Minify JS/CSS
- Public label: Minify JS/CSS
- Location: Plugin Settings > Performance > Indexing And Cache
- Type: Toggle
- Default value: Off
- Shown when: Always.
- Availability: Free
- What it does: Minifies plugin frontend JavaScript and CSS assets.
- When to use: Use it when the site does not already minify these assets through a build process or optimization plugin.
- Side effects / performance notes: Double-minification or optimization plugins can occasionally create compatibility issues.
- Related options: Exclude from JS Optimization, Disable Plugin Styles, Theme Compatibility Mode.
Index Grouped And Bundle
- Public label: Index Grouped & Bundle
- Location: Plugin Settings > Performance > Indexing And Cache
- Type: Toggle
- Default value: Off
- Shown when: Always.
- Availability: Free
- What it does: Enables indexing behavior for grouped and bundled product relationships.
- When to use: Use it when the catalog relies on grouped products or product bundles in filtering.
- Side effects / performance notes: Additional product relationship indexing can increase rebuild time.
- Related options: Index Grouped Products, Index Bundled Products, Rebuild Scope.
Counts
Show Counts in Filters
- Public label: Show Counts in Filters
- Location: Plugin Settings > Performance > Counts
- Type: Toggle
- Default value: None
- Shown when: Always.
- Availability: Free
- What it does: Shows product counts next to filter values.
- When to use: Use it when shoppers benefit from seeing how many products match each value.
- Side effects / performance notes: Counts can add query work, especially with live recounting and large catalogs.
- Related options: Count Calculation Mode, Count Font Color, Recount Products.
Count Calculation Mode
- Public label: Count Calculation Mode
- Location: Plugin Settings > Performance > Counts
- Type: Radio
- Default value:
Static / Instant / Live - Shown when: Show Counts in Filters is enabled.
- Availability: Free
- What it does: Chooses how product counts are calculated and refreshed.
- When to use: Use Static for speed, Instant for quicker visible updates, or Live when counts must reflect active selections closely.
- Side effects / performance notes: More dynamic count modes can increase server and AJAX workload.
- Related options: Show Counts in Filters, Force Live Recount, Animate Count Updates.
Hide Empty Filter Values
- Public label: Hide Empty Filter Values
- Location: Plugin Settings > Performance > Counts
- Type: Toggle
- Default value: None
- Shown when: Always.
- Availability: Free
- What it does: Hides values that would not return products.
- When to use: Use it when shoppers should see only useful choices.
- Side effects / performance notes: Hidden values can make filter lists change after selections, which should be checked for usability.
- Related options: Adaptive Filtering, Show Disabled As Greyed, No Products Found Message.
Animate Count Updates
- Public label: Animate Count Updates
- Location: Plugin Settings > Performance > Counts
- Type: Toggle
- Default value: None
- Shown when: Show Counts in Filters is enabled.
- Availability: Free
- What it does: Animates count changes when filter results update.
- When to use: Use it when count changes should feel more noticeable.
- Side effects / performance notes: Animation can add visual noise on filters with many values.
- Related options: Count Calculation Mode, AJAX Debounce, Show Counts in Filters.
Product Relationship Indexing
Index Grouped Products
- Public label: Index Grouped Products
- Location: Plugin Settings > Performance > Product Relationship Indexing
- Type: Toggle
- Default value: None
- Shown when: Grouped product indexing is relevant.
- Availability: Free
- What it does: Includes grouped products in the indexing process.
- When to use: Use it when grouped products should participate in filtering and counts.
- Side effects / performance notes: Grouped relationships can make indexing slower on large catalogs.
- Related options: Index Grouped & Bundle, Index Bundled Products, Rebuild Index.
Index Bundled Products
- Public label: Index Bundled Products
- Location: Plugin Settings > Performance > Product Relationship Indexing
- Type: Toggle
- Default value: None
- Shown when: Bundled product indexing is relevant.
- Availability: Free
- What it does: Includes bundled products in the indexing process.
- When to use: Use it when bundle components or bundled products should influence filtering.
- Side effects / performance notes: Bundle indexing can require compatibility checks with the bundle plugin in use.
- Related options: Index Grouped & Bundle, Index Grouped Products, Theme Compatibility Mode.
Limits And Timing
Cache TTL
- Public label: Cache TTL
- Location: Plugin Settings > Performance > Limits And Timing
- Type: Number
- Default value:
3600 s - Shown when: Cache Filter Results is enabled.
- Availability: Free
- What it does: Sets how long cached filter results remain valid.
- When to use: Increase it for stable catalogs or reduce it when products, prices, or stock change frequently.
- Side effects / performance notes: Longer TTLs improve cache reuse but can show stale filtered results longer.
- Related options: Cache Filter Results, Rebuild Index, Remove Data on Uninstall.
AJAX Timeout
- Public label: AJAX Timeout
- Location: Plugin Settings > Performance > Limits And Timing
- Type: Number
- Default value:
10000 ms - Shown when: Always.
- Availability: Free
- What it does: Sets how long AJAX filtering can wait before timing out.
- When to use: Increase it for slower servers or large catalogs where filtering needs more time.
- Side effects / performance notes: Long timeouts can make failed requests feel stuck; short timeouts can interrupt valid slow queries.
- Related options: AJAX Debounce, Max Products Per Query, Filter Loading Strategy.
Max Products Per Query
- Public label: Max Products Per Query
- Location: Plugin Settings > Performance > Limits And Timing
- Type: Number
- Default value:
0 (no limit) - Shown when: Always.
- Availability: Free
- What it does: Limits how many products a filtering query can process.
- When to use: Use it only when very large queries need a hard safety cap.
- Side effects / performance notes: A limit can improve worst-case performance but may make results incomplete if set too low.
- Related options: Products Per Page, AJAX Timeout, Enable Index Tables.
Transient Prefix
- Public label: Transient Prefix
- Location: Plugin Settings > Performance > Limits And Timing
- Type: Text
- Default value: Internal plugin cache prefix
- Shown when: Cache Filter Results is enabled.
- Availability: Free
- What it does: Sets the prefix used for plugin transient cache entries.
- When to use: Change it only for developer-led cache isolation or troubleshooting.
- Side effects / performance notes: Changing the prefix can orphan old cache entries or prevent expected cache reuse.
- Related options: Cache Filter Results, Cache TTL, Debug Mode.