Docs/Troubleshooting/My storefront is blank or showing errors

My storefront is blank or showing errors

Most common causes: theme not published, broken Liquid in your customizations, or app embed failure.

Customers report that your-store.storra.xyz shows a blank page, an error, or the wrong content. Diagnose:

1. Is a theme published?

Go to Themes. The published snapshot should have a green badge. If nothing is published (everything is draft), the storefront falls back to a minimal layout that may look broken.

Fix: Click Publish on the snapshot you want live.

2. Did you save broken Liquid in the code editor?

Liquid syntax errors fail loudly. Open the code editor and look for files marked with a red dot — that's the linter telling you something's wrong. Common errors: unclosed {% if %} or {% for %} blocks, undefined variables, deprecated tags.

Fix: Fix the syntax error, save, refresh your storefront. If you can't find it, revert to a previous snapshot from the snapshot list.

3. App embed crashing

If a recently-installed app's embed has a JS bug, it can break the page. Check the browser console — look for messages like "[storra-embed:cookie-consent] error: ...". Toggle that embed off in the app's detail page to confirm.

Fix: Disable the offending embed; report the bug at storra.xyz/bugs.

4. Custom domain DNS issue

If you're using a custom domain and it just stopped working, check whether DNS still resolves. Run dig your-domain.com from a terminal. If the CNAME doesn't point at stores.storra.xyz anymore, your DNS provider may have changed it.

Fix: Re-add the CNAME record. While DNS propagates, customers can reach your store at your-slug.storra.xyz.

5. Storra is down

Check our status page (link from the storra.xyz footer). If we're having an incident, sit tight — we'll post updates.

Was this page helpful?Suggest an edit →

Updated recently