Advanced Settings
Configure API logging, debug mode, webhook timeouts, cache TTL, and other advanced options.
Advanced Settings
Advanced settings give you low-level control over how FilterIQ operates. You can find these options in the app dashboard under Settings > Advanced.
Debug Mode
Debug mode adds extra logging to the storefront console and the app dashboard. This is useful for diagnosing issues with search, filters, or data sync.
- Go to Settings > Advanced > Debug Mode
- Toggle Enable debug mode on
- Click Save
When debug mode is enabled:
- The storefront JavaScript logs detailed request/response data to the browser console (prefixed with
[SSF:DEBUG]) - The dashboard shows raw API responses alongside formatted data
- Webhook processing logs include full payload details
Turn debug mode off when you are done troubleshooting. It adds overhead to every request and exposes internal details in the browser console.
API Logging Level
Control how much detail is captured in API logs. Navigate to Settings > Advanced > Logging.
| Level | What It Captures |
|---|---|
| Error (default) | Only failed requests and exceptions |
| Warning | Errors plus slow queries and deprecation notices |
| Info | Warnings plus all successful API calls |
| Debug | Everything, including full request/response payloads |
Higher logging levels generate more data and may affect performance. Use Info or Debug only when actively troubleshooting an issue.
Maintenance Window
If you need to perform bulk catalog operations (large CSV imports, bulk price changes, etc.), you can set a maintenance window to temporarily pause webhook processing. This prevents a flood of individual product updates from overwhelming the sync pipeline.
- Go to Settings > Advanced > Maintenance Window
- Set the Start time and Duration (maximum 4 hours)
- Click Schedule
During the maintenance window:
- Incoming webhooks are acknowledged (HTTP 200) but queued instead of processed immediately
- A full re-sync runs automatically when the window closes
- Your storefront continues to serve search results from the existing index
Webhook Timeout Configuration
Control how long the backend waits for Shopify webhook processing before timing out.
| Setting | Default | Range | Description |
|---|---|---|---|
| Processing timeout | 10s | 5-30s | Max time to process a single webhook |
| Batch timeout | 60s | 30-120s | Max time for batch webhook processing |
If you have very large products (many variants, extensive metafields), you may need to increase the processing timeout. Go to Settings > Advanced > Webhooks to adjust these values.
Bulk Operation Limits
These settings control the size and frequency of bulk operations like full re-syncs, CSV exports, and batch updates.
| Setting | Default | Description |
|---|---|---|
| Max products per batch | 100 | Products processed per batch during re-sync |
| Concurrent batches | 3 | Number of batches processed simultaneously |
| Re-sync cooldown | 15 minutes | Minimum time between manual re-syncs |
For stores with very large catalogs (50,000+ products), you may want to reduce concurrent batches to avoid hitting Shopify API rate limits.
Cache TTL Settings
FilterIQ caches several types of data to keep your storefront fast. You can adjust cache lifetimes in Settings > Advanced > Cache.
FilterIQ caches several types of data to keep your storefront fast -- search results, filter counts, autocomplete suggestions, and product data. Each cache type has a sensible default that balances freshness with performance.
Lower cache lifetimes mean shoppers see changes faster but generate more load on the search engine. Higher values improve performance but may show slightly stale data.
You can adjust cache lifetimes using the sliders in this section.
After changing cache settings, click Purge Cache to clear all cached data immediately.
Re-register Webhooks
If product changes are not syncing to your search index, the Shopify webhooks may have become unregistered. This can happen after extended Shopify outages or if your app permissions were modified.
To re-register all webhooks:
- Go to Settings > Advanced > Webhooks
- Click Re-register Webhooks
- Wait for the confirmation message
This re-creates all required webhook subscriptions with Shopify. It does not affect your existing data or settings.
Advanced Troubleshooting (Support Token)
For complex issues that require direct investigation by our support team, you can generate a temporary support token.
- Go to Settings > Advanced > Support Access
- Click Generate Support Token
- Copy the token and send it to support@filteriq.app
The support token:
- Grants our team read-only access to your app configuration and logs
- Expires automatically after 48 hours
- Can be revoked at any time by clicking Revoke Token
- Never grants access to your Shopify admin or customer data
If you are experiencing an issue you cannot resolve with the documentation or standard troubleshooting steps, generate a support token and email it to support@filteriq.app along with a description of the problem.