Troubleshooting

Start here when something looks wrong on the storefront. Work through the matching section, then re-check the Full launch checklist. Marketplace-ready launches also benefit from the new Locations, Search and discovery, Retail conversion, Retention and accounts, Privacy and consent, and Performance guides.

Online Store → Themes → Customize → Theme settings

Book buttons do not open the right page

• Confirm Theme settings → Booking provider matches your setup (Hollow Reserve or External).
• For Hollow Reserve: confirm the booking block is on /pages/booking or the current template, then hard-refresh.
• For External: confirm Booking base URL is set and saved.
• Confirm the block’s Linked product is a service product with the handle your scheduler expects.
• If Book still does nothing, confirm data-hr-fallback-href or the link href is present on the control.
• Test on the published theme preview URL, not only the Theme Editor canvas.

Aftercare upsells missing in cart

• Confirm the service product has custom.service_pairing populated with live aftercare products.
• Add the service (not only aftercare) to the cart so Top pick / Also consider can appear.
• Confirm Theme settings → Cart upsells are enabled for the drawer or cart page you use.
• See Revenue setup and Retail conversion for the full pairing path.

Store feels slow or motion is stuck on

• Set Motion intensity to Subtle; turn Magnetic CTAs and Smooth momentum scroll Off.
• Compress hero images and add a poster for hero video.
• Confirm the storefront Animations toggle and OS reduced motion disable heavy effects.
• See Keep your storefront fast.

Search or menus look broken

• Confirm primary and footer menus are assigned in the Header and Footer sections.
• Include search in mobile header utilities if phones cannot find the icon.
• If mega menu will not close, press Escape and check for overlapping sticky sections.
• See Header and navigation and Search and discovery.

Analytics never loads (or loads without consent)

• Confirm Shopify Customer Privacy / cookie banner settings for your markets.
• Confirm Theme settings → Analytics GTM ID uses the GTM- prefix.
• Accept tracking in a private window and confirm the container loads once.
• See Privacy and consent.

Portfolio gallery shows only some photos

• Check Progressive load → Reveal more photos. Show all displays every piece; Load more and On scroll hide extras until shoppers reveal them.
• Confirm Initial visible photos is lower than your piece count when you want a Load more control.
• On scroll falls back to a Load more button when the shopper’s device prefers reduced motion.
• Filter chips reset the visible batch to the initial count—switch back to All if a tag hides most pieces.
• The lightbox only steps through photos that are currently revealed (not filtered out and not still hidden).

Ready to publish?

Complete the Full launch checklist (including Conversion Starter or Full Editorial preset choice when available), preview on mobile, and keep a duplicate theme for rollback. Support: Arcanum Hollow Labs via your usual channel — docs live on https://www.arcanumhollow.com/shops/docs/studio-arcana.