Product Syncing

FilterIQ maintains its own search index of your products. The Sync page (/app/sync) gives you full visibility into how your product data flows from Shopify into FilterIQ's search engine.

Sync Dashboard

When you open the Sync page, you see four key indicators at the top:

Indicator	What It Shows
Last Sync	Timestamp of the most recent successful sync
Products Indexed	Total number of products currently in the search index
Sync Errors	Number of products that failed to sync (if any)
Health	Overall sync health indicator (Healthy, Warning, or Error)

A Healthy status means your index is up to date with your Shopify catalog. A Warning status indicates a minor issue such as stale data. An Error status means sync has failed and needs attention.

Sync Types

Full Sync

A full sync re-indexes your entire product catalog from scratch. Use this when:

You have made bulk changes to your catalog (bulk price updates, bulk tag changes)
Your sync health shows errors or stale data
You want to ensure your index is completely up to date

To run a full sync, click the Full Sync button on the Sync page. A progress indicator appears showing how many products have been processed.

Note: Full syncs can take several minutes for large catalogs. You can navigate away from the page -- the sync continues in the background.

Quick Sync

A quick sync only processes products that have changed since the last sync. It is faster than a full sync and is suitable for routine maintenance.

Click the Quick Sync button to start a quick sync. This is useful if you have recently added or updated a small number of products and want the changes reflected immediately.

Auto-Sync

The Auto-Sync toggle controls whether FilterIQ automatically syncs product changes in the background.

Enabled (recommended): FilterIQ listens for Shopify webhooks and automatically updates the index when products are created, updated, or deleted. This is the default setting.
Disabled: You must manually trigger syncs. Use this if you want full control over when your index updates.

Toggle Auto-Sync on or off directly from the Sync page.

What Triggers Automatic Syncs

When Auto-Sync is enabled, the following Shopify events trigger an index update:

Product created -- New product is added to the index
Product updated -- Changed product data (title, description, price, tags, variants) is re-indexed
Product deleted -- Product is removed from the index

These updates happen via Shopify webhooks and typically reflect in your search results within a few seconds.

Sync History

Below the sync controls, you will find the Sync History table. This table shows a log of all past sync operations with the following columns:

Column	Description
Timestamp	When the sync started
Type	Full Sync or Quick Sync
Duration	How long the sync took
Products Synced	Number of products processed
Errors	Number of products that failed to sync
Status	Completed, Failed, or In Progress

Use the sync history to diagnose issues. If you see repeated failures, check the error count and contact support with the details.

Progress Indicator

When a sync is actively running, a progress bar appears at the top of the Sync page showing:

Number of products processed out of total
Estimated time remaining
Current sync phase (fetching, indexing, finalizing)

You can safely leave the page while a sync is running. When you return, the progress indicator updates to reflect the current state.

Re-Register Webhooks

If automatic syncs stop working (for example, after a Shopify plan change or app reinstallation), you can re-register webhooks manually:

Scroll to the bottom of the Sync page
Click the Re-register Webhooks button
Wait for confirmation that webhooks are registered

This forces FilterIQ to re-subscribe to Shopify product events, resolving most webhook delivery issues.

Rate Limits

Sync operations respect Shopify's API rate limits:

FilterIQ uses bulk API operations where possible to minimize API calls
If your store hits Shopify's rate limit, the sync pauses automatically and resumes when the rate limit resets
You cannot run two syncs simultaneously -- if a sync is already in progress, the sync buttons are disabled

Troubleshooting Sync Issues

Products not appearing in search

Check the Products Indexed count against your actual product count in Shopify
Run a Full Sync to force a complete re-index
Verify that the products are published to your Online Store sales channel

Sync errors

Review the error count in the Sync History table
Common causes: products with invalid data, metafield format issues, or API timeouts
If errors persist after a full sync, contact support@filteriq.app with the error details

Stale data

If product changes are not reflected in search, check that Auto-Sync is enabled
Try a Quick Sync to process recent changes
If the issue persists, click Re-register Webhooks and then run a Full Sync