What this guide covers
This article explains how legacy shops can upgrade to the latest version of the app. It is written for store owners and admins who want a smooth update path.
Why upgrade?
Upgrading gives you:
- the latest app features,
- improved performance,
- better theme support,
- easier filter and search setup.
If your shop is marked as legacy, this guide helps you move to the current version safely.
Step 1: Check your current setup
- Open the dashboard.
- Look for a note or warning about legacy mode.
- Follow any prompt that says your theme or app version is outdated.
Screenshot: Show the dashboard home page with a legacy warning or update prompt.
Step 2: Prepare your store
- Save any changes in the dashboard before moving forward.
- If you have active filters, note which ones are currently published.
- Make sure your theme is available and not restricted.
Screenshot: Show the Filters or Templates page with saved items and published status.
Step 3: Start the upgrade process
- Open the app setup or onboarding area in the dashboard.
- Find the update or upgrade prompt for legacy shops.
- Click the button that starts the upgrade.
Screenshot: Show the legacy upgrade prompt or setup guide with an action button.
Step 4: Follow the guided steps
- The dashboard will show a list of next steps.
- Complete them in order: Billing, Products Sync, Theme Setup, then Preview.
- If the app asks to enable theme features, accept and save those changes.
Screenshot: Show setup cards with completed and pending steps.
Step 5: Update theme support
- Open Theme Setup.
- Follow the instructions for your theme.
- Enable the app embed and filter location when prompted.
- Save the theme settings.
If you see a legacy theme message, follow the upgrade flow until the message disappears.
Screenshot: Show Theme Setup page with embed and filter block options.
Step 6: Sync your products
- Open Products Sync.
- Start the sync if it has not run automatically.
- Wait until the sync completes.
This ensures your filters and search are using current product data.
Screenshot: Show Products Sync status and retry button.
Step 7: Verify your store
- Visit your storefront in a new browser tab.
- Check that filters appear correctly.
- Test a few search or filter actions to confirm they work.
Screenshot: Show storefront with active filters and search field.
What to do if something goes wrong
If the upgrade stops or fails
- Refresh the dashboard and try the upgrade again.
- Return to the setup page and complete any pending steps.
- If the problem continues, contact support.
If filters do not appear after upgrade
- Go back to Filters and confirm the filter is published.
- Run Products Sync again.
- Reload your storefront.
If theme setup is still legacy
- Open Theme Setup and repeat the theme upgrade steps.
- Look for any saved messages or warnings.
Screenshot: Show a warning message or legacy theme alert.
Best practices for legacy upgrades
- Backup your current theme or note your active settings before upgrading.
- Complete one step at a time.
- Save changes after each step.
- Check your storefront after each major update.
When to contact support
Contact support if:
- you cannot start the upgrade,
- the app still shows legacy status after completing steps,
- your filters or theme do not work after upgrade.
Tell support what page you were on and which step failed.