Help
Troubleshooting
Diagnose a problem before you contact support.
On this page
- First steps
- Common problems
- A section is empty or shows a gray illustration
- Sample text is showing
- The header isn't transparent
- The menu promotion doesn't appear
- Recommendations don't show
- Filters don't show
- Choosing an option on the home page opens the product page
- Adding to cart fails for some variants
- The contact form doesn't send anything
- An app doesn't show
- Still stuck?
First steps
Clear your cache and test in a private window
An old version of the page or a browser extension can affect what you see.
Test on a fresh copy of the theme
Add an unmodified copy of Maison to your theme library and check whether the problem happens there. If it goes away, it comes from a code change, custom Liquid code, or an app.
Turn off app embeds
In the theme editor, open App embeds and turn them off one by one to find the one causing the problem.
Check the theme version
A problem may already be fixed in a newer version. See the release notes.
Common problems
A section is empty or shows a gray illustration
The section's resource (image, collection, product, blog) hasn't been chosen, or the collection is empty. Placeholder illustrations are intentionally shown on your live store too.
Sample text is showing
The included templates contain sample content: text in the Hero, Statement, Services, and Newsletter sections, the product page's collapsible rows, and the announcement bar. Replace it in the theme editor.
The header isn't transparent
See Transparent header.
The menu promotion doesn't appear
The title entered in Menu item must exactly match a top-level item that has child items. Promotions only show on desktop, or at the bottom of the drawer's subpanel on mobile. See Menu promotion.
Recommendations don't show
Shopify doesn't have enough data yet (new store), or no complementary products are defined in Search & Discovery. The section then hides itself.
Filters don't show
Check that they're published in Search & Discovery, that Enable filtering is checked, and that the collection has fewer than 5,000 products. See Collection filters.
Choosing an option on the home page opens the product page
This is the intended behavior of the Featured product section when Shopify can't recalculate the combination in place. See Featured product.
Adding to cart fails for some variants
If the variant has a minimum quantity greater than 1, show a quantity selector (Quantity block, or the Buy buttons block option). Also check the variant's inventory.
The contact form doesn't send anything
Check your store's email address in SettingsStore details, and check your spam folder. Shopify may also show a spam check (hCaptcha) when the form is submitted.
An app doesn't show
Check that its block is added to a section that accepts app blocks, or that its app embed is turned on. See Apps.
Still stuck?
Contact support with your store address, theme version, the page affected, and the steps to reproduce the problem.
Maison 1.0.0