# FAQ and Troubleshooting

This section covers frequently asked questions and troubleshooting guides for the Plain Jane theme.

## 🛠️ Installation & Setup

### Q: How do I install the Plain Jane theme?

**A:** Follow our step-by-step guide in the [Installing the Plain Jane Theme](https://github.com/OpenSpaces-Design/theme-documentation/blob/v3/plain-jane/broken-reference/README.md) section. You can install it through the Shopify Theme Store or by uploading the theme files directly.

### Q: Can I preview the theme before making it live?

**A:** Yes! After installing the theme, you can preview it by going to **Online Store → Themes** and clicking **Preview** on the Plain Jane theme. This lets you see how it looks without affecting your live store.

### Q: How do I switch between different menu layouts?

**A:** The Plain Jane theme offers three menu layouts:

* **Center Menu**: Best for minimal branding
* **Side-Aligned Menu**: Perfect for showcasing your logo
* **Compact Menu**: Ideal for stores with many navigation items

Switch between them in **Theme Settings → Homepage + Menu** section.

## 🎨 Design & Customization

### Q: How do I change the main theme color?

**A:** Go to **Theme Settings → Main Theme Color** and select your desired color. This will update accent colors, buttons, and interactive elements throughout your store.

### Q: Can I customize fonts?

**A:** Yes! Navigate to **Theme Settings → Typography Settings** to choose from various font combinations or upload custom fonts. You can set different fonts for headings and body text.

### Q: How do I add my logo?

**A:** Upload your logo in **Theme Settings → Logo Settings**. You can adjust the logo size and positioning to match your brand.

### Q: How do I set up a password page for my store launch?

**A:** Follow our comprehensive guide in [Password Page Setup](https://github.com/OpenSpaces-Design/theme-documentation/blob/v3/plain-jane/broken-reference/README.md). You can collect emails, add countdown timers, and create anticipation for your launch.

## 📱 Mobile & Responsive Design

### Q: Is the Plain Jane theme mobile-responsive?

**A:** Absolutely! Plain Jane is fully responsive and optimized for all devices. The theme automatically adapts to different screen sizes and provides an excellent mobile shopping experience.

### Q: Why do some features look different on mobile?

**A:** This is intentional design. Certain elements are optimized specifically for mobile viewing to ensure better usability and faster loading times on mobile devices.

## 🛒 Product & Collection Setup

### Q: How do I set up product variants (colors, sizes)?

**A:** You can set up variants in your Shopify admin under **Products**. For enhanced variant display, check our guides on [Setting Up Color Swatches](https://github.com/OpenSpaces-Design/theme-documentation/blob/v3/plain-jane/broken-reference/README.md) and size charts.

### Q: How do I organize my collections?

**A:** Use our [Collection Page Setup](/plain-jane-interactive/getting-started/3.-creating-and-customizing-your-collections-page.md) guide to learn about the different collection layouts available and how to customize them.

### Q: Can I add size charts to my products?

**A:** Yes! Follow our [How to Add Size Charts](/plain-jane-interactive/advanced/how-to-add-size-charts-to-each-product.md) guide to add detailed size information to your products.

## 🔧 Advanced Features

### Q: How do I set up pre-orders?

**A:** Use our [Setting Up Pre-Orders](/plain-jane-interactive/advanced/setting-up-pre-orders.md) guide to enable pre-order functionality for upcoming products.

### Q: Can I add a blog to my store?

**A:** Yes! Use the Blog Feed Section to display your blog posts. You can customize the layout and choose how many posts to show.

### Q: How do I set up customer accounts?

**A:** Enable customer accounts in your Shopify settings, then customize the account pages using our [Customer Accounts](/plain-jane-interactive/customer-accounts.md) guides.

## 🚀 Performance & SEO

### Q: How do I optimize my store for search engines?

**A:** Use our SEO guides in the [Languages & SEO](/plain-jane-interactive/theme-settings/languages-and-seo.md) section to set up meta descriptions, update your favicon, and optimize your content.

### Q: Is the theme optimized for speed?

**A:** Yes! Plain Jane is built with performance in mind, featuring optimized code, efficient image loading, and minimal resource usage.

### Q: How do I add Google Analytics?

**A:** Add your Google Analytics tracking code in **Theme Settings → SEO Settings** under the "Google Analytics" field.

## 🎵 Special Features

### Q: How does the music player work?

**A:** The music player allows you to add ambient music to your store. Configure it in **Theme Settings → Music Player Settings**. You can upload audio files and control playback settings.

### Q: What are the animation options?

**A:** Plain Jane includes subtle animations that enhance the user experience. You can enable/disable animations in **Theme Settings → Animations**.

### Q: How do I set up the preloader?

**A:** The preloader creates a smooth loading experience. Configure it in the **Preloader Section** to match your brand aesthetic.

## ⚠️ Common Issues & Solutions

### Issue: Theme not displaying correctly after installation

**Solution:**

1. Clear your browser cache
2. Check if you're viewing the correct theme preview
3. Ensure all theme files uploaded successfully
4. Contact support if issues persist

### Issue: Images not loading properly

**Solution:**

1. Check image file sizes (recommend under 2MB)
2. Ensure images are in supported formats (JPG, PNG, WebP)
3. Re-upload images through Shopify admin
4. Check your CDN settings

### Issue: Menu items not appearing

**Solution:**

1. Verify menu is set up correctly in **Navigation**
2. Check if menu is assigned to the correct menu location
3. Ensure menu items are published and visible

### Issue: Mobile layout issues

**Solution:**

1. Clear mobile browser cache
2. Test on different mobile devices
3. Check if any custom CSS is interfering
4. Verify responsive settings in theme customizer

### Issue: Checkout process problems

**Solution:**

1. Test checkout process in incognito/private browsing
2. Check Shopify payment settings
3. Verify shipping settings are configured
4. Ensure checkout is enabled in your Shopify plan

## 📞 Getting Help

### When to Contact Support

* Theme installation issues that persist after following guides
* Custom feature requests
* Technical bugs not covered in this FAQ
* Integration questions with third-party apps

### Before Contacting Support

1. Check this FAQ section
2. Review the relevant documentation section
3. Clear your browser cache and test again
4. Note your Shopify plan and any installed apps
5. Take screenshots if there are visual issues

### How to Contact Support

* **Email**: Include your store URL, theme version, and detailed description of the issue
* **Screenshots**: Always helpful for visual issues
* **Steps to Reproduce**: Explain exactly what you did when the issue occurred

## 🔗 Useful Resources

* [Shopify Help Center](https://help.shopify.com/)
* [Shopify Community](https://community.shopify.com/)
* [Theme Development Documentation](https://shopify.dev/themes)
* [Liquid Template Language](https://shopify.github.io/liquid/)

## 📋 Theme Limitations

### What Plain Jane Cannot Do

* Completely custom checkout pages (Shopify limitation)
* Modify Shopify's core functionality
* Create new product types beyond Shopify's structure
* Process payments (handled by Shopify)

### Recommended Third-Party Apps

For functionality beyond the theme's scope, consider these app categories:

* **Reviews**: Product review apps
* **Email Marketing**: Newsletter and email automation
* **Inventory**: Advanced inventory management
* **Analytics**: Enhanced store analytics
* **Marketing**: SEO and social media tools

Remember: Most issues can be resolved by carefully following our documentation. If you're still having trouble, don't hesitate to reach out for support!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.openspaces.design/readme-1/faq-and-troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
