📖 Here are some common issues you may encounter when setting up themes with the App's filter & search and ways to address them.
How can I check if my current theme version is supported?
Our app supports all free themes and most installed themes in the Shopify theme store. We will always keep track of the latest updates of these themes as well as release support versions for other themes in the future.
To check the theme version of any theme:
From Shopify’s App Admin > Online store > Themes.
In [Target Theme] > Select Edit code in the drop-down of “...” icon.
Search and open the file settings_schema.json > Check theme_name and theme_version.
Compare your current theme version to our supported themes list.
If your current theme version is in the supported themes list, you can follow this theme set-up guide to integrate our app feature into your theme. On the contrary, you can set up a theme manually or customize our auto-applied default theme.
Why are some themes missing from Themes with the app's filter & search?
After implementing the theme setup process, all themes that have our app will be listed in the Themes with the app's filter & search.
To check the themes set up library:
From App Admin > go to Integration > select Shopify Integration.
Set-up themes will be displayed in order of the most recent date.
If some themes do not show up in the list, there could be down to some reasons:
Themes are not set up automatically: If you copied PFS files from one store to another without running the theme setup process, the new theme will not be added to the setup themes list.
Sync error between Boost and Shopify: During synchronization, an error retrieving data from Shopify may prevent some themes from displaying. In this case, your setup themes may appear incomplete.
Shopify theme limit reached: Shopify limits the number of themes per store:
20 themes on standard plans
Up to 100 themes on Shopify Plus
If you’ve reached this limit, you’ll need to remove a theme before adding a new one.
To manually update the themes list:
From App Admin > go to Integration menu > select Shopify Integration > Theme Setup
Select Refresh. The refresh process will finish in about 3 minutes.
Check how your themes are displayed in the list.
Why does my store look different after publishing your app-integrated theme?
After publishing a new theme with our app's features, you may notice the theme's layout is not rightly displayed and some elements can be missing. Some elements and layouts can look different for some reasons:
The default theme/ Original theme is applied to the live theme
The default theme will be applied automatically during the theme setup process when:
[Target Theme] is not in our supported themes list
[Target Theme] is in our supported themes list and it was heavily customized. If your theme customization is insignificant, our app will set up app features on the original version of that theme instead of the customized theme.
To retain your theme customization, you can either:
Manually install our app on that customized theme
Customize the product items display to match your current theme layout
Contact us for custom theme requests
Lack of third-party app interference
If you create and publish a new theme without integrating it with third-party store apps, these apps may trigger glitches on the storefront. To eliminate this issue, you can follow this guide to integrate third-party apps with your new theme.
Our supported themes list is not up to date
In case we miss theme updates from the theme maker, the latest layout may not fully display on the app-integrated theme.
Please contact us to keep up with the latest theme updates.
How to transfer filter and search settings between themes?
When a new theme is set up automatically, the settings and data of filter and search settings will be synchronized between all themes in the themes set-up library.
In case you want a theme with our app's features to go live, you can follow our theme setup and publish a guide.
Feel free to reach out to our dedicated support team via chat if you have any questions or require additional assistance.