Skip to main content
FilterIQRequest access
Menu
Type to search across all documentation
NavigateEnterOpenEscClose
3 min read

Migrate from Shopify Native Search

How to upgrade from Shopify's built-in search to FilterIQ.

Migrate from Shopify Native Search

Plan a controlled move from your current Shopify search configuration. FilterIQ is in private preview; access, catalogue sync and theme validation are separate steps, and their timing varies.

What Changes

Shopify provides predictive search and typo tolerance, and Search & Discovery adds filters, synonyms, boosts and reports. Review the Shopify storefront search guide before deciding which settings need to change.

AreaWhat to record and validate
QueriesKnown products, misspellings, synonyms and empty-result queries
FiltersSource attributes, value groups, ordering and collection scope
MerchandisingBoosted or hidden products and overlapping rule behaviour
AnalyticsAvailable baseline data and tracking coverage
ThemeSearch input, collection grid, mobile controls and other app integrations

Migration Steps

Step 1: Install FilterIQ

  1. Request private-preview access and confirm the required features and plan.
  2. If accepted, follow the installation path supplied by the team and review the Shopify approval screens.
  3. Create a duplicate theme and record the current configuration. Confirm which app settings affect the whole store before changing them.
  4. Review an AI-assisted draft, then enable the supplied Theme App Extension in the duplicate theme preview.

Step 2: Verify Search Works

  1. Open the duplicate theme preview.
  2. Replay the recorded query set and check the actual products returned.
  3. Test filter combinations, empty results, sorting and clearing selections.
  4. Check keyboard navigation and mobile controls, then record any differences from the current storefront.

Step 3: Validate the Theme Integration and Switch

  1. Check how the extension attaches to the theme's existing search input; do not remove that input simply to install the extension.
  2. Resolve overlapping search or filter controls in the duplicate theme.
  3. Confirm the rollback procedure and any store-wide publish effects with the team.
  4. Publish the accepted theme/configuration and repeat the same search and filter checks on the live storefront.

What About My Existing Search Data?

  • Search settings and history: Keep a record of the settings and reports available in Shopify. Do not assume that previous synonyms, boosts or analytics are imported.
  • Product data: FilterIQ uses Shopify catalogue data; verify sync coverage and plan limits.
  • Collections: Test the collections and filter scopes your shoppers use.
  • URLs: Test existing search links and bookmarked filter states before switching; do not assume that URL behaviour is identical.

Rollback

If you want to revert to native search:

  1. Restore the retained theme and its recorded search settings, including any original app embed state.
  2. Disable the FilterIQ integration for that theme and review any shared app configuration changes.
  3. Test the original search, filters and URLs before treating rollback as successful.
  4. Consider uninstalling only after the required storefront behaviour and billing consequences have been reviewed.
Was this page helpful?