Most failed installs come down to a few recurring mistakes. Run through this list before digging deeper.
- Wrong collection ID: the snippet points at an ID that doesn’t exist or isn’t published. Copy the ID straight from the collection.
- Script loaded with async after a render-blocking script: it can fail to mount. Use defer instead.
- Zero-height container: the placeholder has no reserved space and collapses. Give it room in your CSS.
- Not published: the page or theme is still a draft. Publish it.
- Catalogue not synced: products don’t appear on tiles. Re-run the store sync.
- Cached page: an old version is being served. Hard-refresh and clear theme or CDN caches.
