Update help docs per Intercom feedback: menu troubleshooting, advanced layouts, grid performance, onboarding, upgrades

general/advanced-menu-layouts.md

@@ -0,0 +1,11 @@
+# Advanced Menu Layouts
+
+Our themes support horizontal (mega menu) and vertical menus. Paper and Keystone have flexible header menu options.
+
+To create a mega menu:
+- In Theme Editor, set Header > Menu Layout to horizontal
+- Add two or more columns and menu cards (for images, descriptions)
+- Use 'Show as mega menu' toggle for Paper/Keystone
+- To fix menu reverting to vertical, make sure top-level menu items have children assigned
+
+Troubleshooting: If your mega menu won't display, double check your nesting and that you've saved changes. Some upgrades (6.x → 8.x or on Paper/Keystone) may reset your menu settings.

general/collection-grid-performance.md

@@ -0,0 +1,10 @@
+# Optimizing Collection Grid Performance
+
+If your collection/product grid is slow to load or seems to freeze, especially with collections with many variants/images:
+
+- Check 'Show variants table' in your product or collection settings—disabling this can substantially speed up DOM load time
+- Limit the number of visible products per page (e.g. 24)
+- Theme loads images for all variants—if you have >10 images per product, this adds up fast
+- Try disabling "load more" pagination if it makes load speeds worse
+
+For further optimization tips, visit [Shopify's collection performance guide](https://help.shopify.com/).

general/menu-troubleshooting.md

@@ -0,0 +1,11 @@
+# Menu & Menu Drawer Troubleshooting
+
+If you're having problems with the menu or menu drawer (for example: doesn't open/close, won't display correctly on the homepage, mega menu layout not appearing), try these steps:
+
+1. Clear your browser cache and test in incognito mode.
+2. Confirm that JavaScript is enabled and no third-party app disables menu features.
+3. After theme upgrades, review header and menu settings: Mega menu, columns, cards, and vertical/horizontal layouts can reset to defaults.
+4. If the issue only happens on the home page (but not other pages), save and republish your header configuration. A fresh theme install may be needed to troubleshoot further.
+5. Still stuck? [Contact support](contact-support.md) with a description and screenshots.
+
+Paper/Keystone: Mega menus require specific column/card configuration. [Read our advanced menu guide](advanced-menu-layouts.md).

general/onboarding-rescheduling-guide.md

@@ -0,0 +1,10 @@
+# Onboarding & Support Call Guide
+
+Need to reschedule your onboarding or support demo?
+
+1. Visit your scheduling link in your onboarding email (or use [this link](https://cal.com/brickspacelab/onboarding))
+2. If a mistake was made, just reply to your onboarding email or contact [support](contact-support.md)
+3. For theme support tickets, always double check your time zone before booking
+4. You’ll receive a confirmation email for every scheduled/rescheduled call
+
+Reach out if you run into any problems!

general/theme-upgrade-customization.md

@@ -0,0 +1,10 @@
+# Theme Upgrade & Customization Tips
+
+Upgrading Paper, Keystone, or Space? Make sure to:
+- Review changes to header, navigation, and color settings
+- If menu, accent, or background colors look off, manually re-assign your 'Accent 1' in the updated theme settings
+- For custom code, test every page before publishing
+- After major upgrades (v5 to v8), configuration for menus and page sections may reset
+- See [menu troubleshooting](menu-troubleshooting.md)
+
+For extra theme tweaks (rounded boxes, hiding collection names), see the relevant theme’s documentation (Keystone, Paper, or Space folders above).