19. FAQ & troubleshooting

The Quick Order page shows an "unavailable" message. The page is deactivated or the subscription lapsed. In General, confirm Quick Order page is activated, and check Plan & Billing. (When a subscription is inactive the page's data API returns 402; when the page is deactivated it returns 403.)

Some customers can't open the page. Check Access restriction in General. With Logged-in or Tagged, others see an inline access-denied panel (with a log-in link) rather than a redirect.

The navigation link is missing. Add the Quick Order Link block in the theme editor (Section 5). It only appears in the block picker while your subscription is active.

The Custom Metafields dropdown is empty. It only lists existing product metafield definitions. Create at least one in Shopify → Settings → Custom data → Products first.

Is the page slow with a huge catalog? It shouldn't be — performance is automatic. The grid stays client-side up to ~50,000 variants and switches to server-side paging above that. There's nothing to configure.

My column changes don't persist. Remember layout must be on (Grid & Columns). Customer layouts live in the browser, so clearing site data removes them.

Why are variants on separate rows? By design — each variant (e.g. Size × Colour) is its own row so customers can order specific variants.

My CSV isn't recognized / imports 0 rows. Use plain-text CSV (not .xlsx), max 5,000 rows, separator ;, , or tab. Check your column mapping and that the right identifier type is chosen. Matching is case-insensitive.

The camera scanner won't open. Shopify stores are HTTPS, so the camera should work — check the browser's camera permission for your store's domain. iOS Safari asks per domain.

My USB scanner doesn't work. Activate Hardware scanner (look for the green Active badge). The scanner must emit keystrokes followed by Enter — most do; if not, enable "keyboard/HID emulation" in its manual. Supported symbologies: EAN-13, EAN-8, UPC-A, Code-128.

The export file is empty. Only rows with qty > 0 are exported — enter quantities first.

I keep seeing the billing prompt. Your subscription is missing, cancelled or frozen. Open Plan & Billing and choose a plan; Managed Pricing activates within seconds. Your settings and saved orders are never lost.

What happens to my data when the trial ends? Nothing is deleted. The storefront page just shows the "unavailable" message until you subscribe again, then works immediately.

Quick Order B2B Grid — fancy|studio