Most collection page problems come down to a handful of causes: the Shopify connection, the theme, or a setting that only applies to some shoppers. Find your symptom below.
Getting started
“Connect Shopify first”
Templates are published into your Shopify theme, so bluebarry needs a connected store. Click Go to integrations and install the bluebarry Shopify app. See Install the bluebarry Shopify app.
“Sync your collections” or a collection is missing
Your store is connected, but bluebarry doesn't know your collections yet, or not all of them. Open the bluebarry app in your Shopify admin and run a full sync. Collections usually appear within a minute. Then click Recheck. The picker lists the same collections you see under Products → Collections, so check there if one is missing. See Browse synced collections.
Publishing
Publishing fails with a message about a vintage theme
Your live theme is an older, vintage theme that can't use the template format collection pages rely on. They need an Online Store 2.0 theme, which almost every current Shopify theme is, including Shopify's free themes. Switch to one, then publish again.
One collection didn't switch
After publishing, Studio lists each collection with a check mark or an error. “Collection no longer exists on Shopify” means it was deleted in Shopify: untick it on the Assign tab. For other errors, click Republish. The last error also stays on the Launch tab under Last publish failed until a publish succeeds.
“Published version is out of date”
You edited the template after publishing, or you switched your store to another Shopify theme. Shoppers still see the last published version. Click Republish to update it.
“Launch is blocked until your changes are saved”
bluebarry saves your latest changes before it opens the Launch tab or publishes, and that save didn't go through. Check your internet connection, wait for the status at the top to show Saved, and try again.
Changes I made in Shopify's theme editor are gone
Every publish replaces the bluebarry sections in your theme with the version from Studio. Make design changes in the collection page editor, or ask Barry, and republish.
I deleted a template and a collection still uses it
Deleting a published template doesn't switch its collections back. In your Shopify admin, open the collection and set its theme template back to the one it used before, usually Default collection. Next time, unpublish before you delete.
On your store
A quiz banner or grid banner doesn't show
- It has no quiz linked. The Launch tab warns you about this. Link a quiz and republish.
- Banners in the grid only show on the first page of a collection.
- The bluebarry app embed is off in your theme. Quiz buttons need it to open the quiz. See Fix the Shopify app embed not showing.
Filters don't show
The filters come from the Shopify Search & Discovery app. If a collection has no filters set up there, the page shows no filter column. Also check that Show filters is on in the product grid settings.
The product order doesn't look personalized
- You switched it on but haven't republished yet.
- The collection is sorted manually in Shopify. That order is always kept.
- You are browsing as a new visitor, or you picked a sort from the dropdown. To test it, view a product a few times and then return to the collection.
- You are in the 10% control group that keeps your normal order. Try another browser.
- The bluebarry app embed is off in your theme.
Shoppers who did the quiz still see the invitation
- Show matches to visitors who did the quizis off, or the template hasn't been republished since you switched it on.
- The quiz they did doesn't count under Which quiz counts, or it was longer ago than Quiz results count for.
- Fewer of their matches are in this collection, and in stock, than Minimum matches.
- They finished the quiz on another device or in another browser.
The live page looks different from the canvas
On your store, the page uses your theme's fonts and base styles, and the filters are your real Search & Discovery filters. Use Preview on the Launch tab to see the real result, and fix differences with custom CSS or by asking Barry.
Still stuck? Contact us with the template name and the collection it's about.