📖 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?
Boost TURBO supports only the themes and theme versions listed in **List of supported Shopify themes for TURBO**.
To check whether your theme is using TURBO or a former version
In Boost admin, go to Integration > Shopify Integration.
Find the theme you want to check.
Review the version label, for example:
Integrated (Version TURBO)
Integrated (Former Version 3.0)
Integrated (Former Version 2.0)
To check the Shopify theme version:
In Shopify admin, go to Online Store > Themes.
On your theme, click ... > Edit code.
Open
config/settings_schema.json.Check
theme_nameandtheme_version.Compare them with the supported version range in List of supported Shopify themes for TURBO.
If your theme is supported, follow How to set up a new theme with Boost Turbo (Supported Themes).
If your theme is not supported, follow the unsupported-theme setup articles instead.
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.