---
title: Troubleshooting
description: Common issues and their solutions
date: 2024-01-31
---

## Blank Pages

### Symptom
WooCommerce pages (shop, cart, checkout) show blank content.

### Solutions

**1. Check SPA Mode Setting**
- Go to **WooNooW → Appearance → General**
- Ensure **SPA Mode** is set to "Full"
- If you want native WooCommerce, set to "Disabled"

**2. Flush Permalinks**
- Go to **Settings → Permalinks**
- Click **Save Changes** (no changes needed)
- This refreshes rewrite rules

**3. Clear Cache**
If using a caching plugin:
- Clear page cache
- Clear object cache
- Purge CDN cache (if applicable)

---

## 404 Errors on SPA Routes

### Symptom
Visiting `/store/shop` or `/store/product/...` shows a 404 error.

### Solutions

**1. Flush Permalinks**
- Go to **Settings → Permalinks**
- Click **Save Changes**

**2. Check Store Page Exists**
- Go to **Pages**
- Verify "Store" page exists and is published
- The page should contain `[woonoow_spa]` shortcode

**3. Check SPA Page Setting**
- Go to **WooNooW → Appearance → General**
- Ensure **SPA Page** is set to the Store page

---

## Product Images Not Loading

### Symptom
Products show placeholder images instead of actual images.

### Solutions

**1. Regenerate Thumbnails**
- Install "Regenerate Thumbnails" plugin
- Run regeneration for all images

**2. Check Image URLs**
- Ensure images have valid URLs
- Check for mixed content (HTTP vs HTTPS)

---

## Slow Performance

### Symptom
SPA feels slow or laggy.

### Solutions

**1. Enable Caching**
- Install a caching plugin (WP Super Cache, W3 Total Cache)
- Enable object caching (Redis/Memcached)

**2. Optimize Images**
- Use WebP format
- Compress images before upload
- Use lazy loading

**3. Check Server Resources**
- Upgrade hosting if on shared hosting
- Consider VPS or managed WordPress hosting

---

## Checkout Not Working

### Symptom
Checkout page won't load or payment fails.

### Solutions

**1. Check Payment Gateway**
- Go to **WooCommerce → Settings → Payments**
- Verify payment method is enabled
- Check API credentials

**2. Check SSL Certificate**
- Checkout requires HTTPS
- Verify SSL is properly installed

**3. Check for JavaScript Errors**
- Open browser Developer Tools (F12)
- Check Console for errors
- Look for blocked scripts

---

## Emails Not Sending

### Symptom
Order confirmation emails not being received.

### Solutions

**1. Check Email Settings**
- Go to **WooNooW → Settings → Notifications**
- Verify email types are enabled

**2. Check WordPress Email**
- Test with a plugin like "Check & Log Email"
- Consider using SMTP plugin (WP Mail SMTP)

**3. Check Spam Folder**
- Emails may be in recipient's spam folder
- Add sender to whitelist

---

## Plugin Conflicts

### Symptom
WooNooW doesn't work after installing another plugin.

### Steps to Diagnose

1. **Deactivate other plugins** one by one
2. **Switch to default theme** (Twenty Twenty-Three)
3. **Check error logs** in `wp-content/debug.log`

### Common Conflicting Plugins

- Other WooCommerce template overrides
- Page builder plugins (sometimes)
- Heavy caching plugins (misconfigured)

---

## Getting More Help

If you can't resolve the issue:

1. **Collect Information**
   - WordPress version
   - WooCommerce version
   - WooNooW version
   - PHP version
   - Error messages (from debug.log)

2. **Enable Debug Mode**
   Add to `wp-config.php`:
   ```php
   define('WP_DEBUG', true);
   define('WP_DEBUG_LOG', true);
   ```

3. **Contact Support**
   Provide the collected information for faster resolution.
