Troubleshooting FlexiBlocks
Common issues when using FlexiBlocks.
App won’t open or auth error
Section titled “App won’t open or auth error”| Check | Action |
|---|---|
| Session expired | Open Shopify Admin → Apps → FlexiBlocks again |
| Wrong shop | Confirm the browser tab shows your .myshopify.com store |
| Cookies blocked | Allow cookies for Shopify and the app origin; try another browser |
Save failed
Section titled “Save failed”| Check | Action |
|---|---|
| API limits | Wait a moment and retry Save |
| Permissions | Confirm staff account can edit content / products |
| Reusable blocks | Complete Settings → Installation |
| Metaobjects | Enable the type and pick a multi-line text body field — Metaobjects |
| Network | Retry on a stable connection |
Changes not in Shopify native editor
Section titled “Changes not in Shopify native editor”- Confirm Save succeeded in FlexiBlocks.
- Refresh the resource in Shopify Admin — both editors use the same HTML fields.
For translated locales, confirm you edited the correct locale in the editor switcher.
Redirected to plan selection
Section titled “Redirected to plan selection”- Expected when no active App Pricing subscription is on file.
- Select Basic (14-day trial, then USD $50/month) in Shopify Admin, then reopen the app.
- See Billing & plans.
Reusable blocks unavailable
Section titled “Reusable blocks unavailable”Complete Settings → Installation once. Library saves trigger sync to referencing pages; if content looks stale, re-save the library entry.
Commerce blocks wrong on storefront
Section titled “Commerce blocks wrong on storefront”| Symptom | Action |
|---|---|
| Empty or static product cards | Enable FlexiBlocks app embed; hard-refresh |
| Old prices after Admin change | Re-save the page or library entry or rely on hydration (embed ON) |
| Add to cart fails | Test on live theme; check theme conflicts — Commerce blocks |
Storefront layout wrong
Section titled “Storefront layout wrong”| Issue | What to try |
|---|---|
| Columns stack | Enable app embed; re-save content |
No data-ecom-gutenberg-hydrated |
Put .ecom-gutenberg-content on the same element as body HTML |
| Collection description | Output {{ collection.description }} inside .ecom-gutenberg-content |
| Responsive card layout | Re-save after changing column/card settings in the editor |
Metaobjects hub empty
Section titled “Metaobjects hub empty”Enable at least one type under Settings → Content types and map a multi-line text field. Create entries in Shopify Admin.
Still stuck?
Section titled “Still stuck?”Email support@k2.digital with your shop domain, steps to reproduce, and screenshots. See Support.